VTAM™ | | LY43-0065-01 
Diagnosis 


Version 4 Release 2 for MVS/ESA, VM/ESA, and VSE/ESA 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 
LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


The VITAM V4R2 Team 


Kan Contgh hh L foe Ge Ce ser ar MU Me 

Kichaaucd (Tak Ese. Dw er 2 “thomas TW 

Nee te Bo foal het jteg rar o Ona ook to taut 
he. ALO wm 

ara Rua. ery MEaek hia A(e- ene cary raalecd 

Conon Brey: RekVEial — Sth Devs ibid ore 

AE \ Erackntch A faire Murr Bow 

Toney Canty — arentien) Ploy Ary WD She Uf? 7 

Prete L Cadlay THD Hodtde- — NTLRe Dalarna Brine thre) Date 

Rotein Ungyivd cps “mores ~———— in i b vers 


raul “Runny ot  Gudbiie 
be Wee uae mt 


VTAM™ LY43-0065-01 
Diagnosis 


Version 4 Release 2 for MVS/ESA, VM/ESA, and VSE/ESA 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 
LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Note! 


Before using this document, read the general information under “Notices” on page xxxvii. 


Second Edition (February 1995) 


This licensed document applies to the Advanced Communications Function for Virtual Telecommunications Access Method 
(ACF/VTAM), an IBM licensed program: 


VTAM Version 4 Release 2 for MVS/ESA (program number 5695-117) 
VTAM Version 4 Release 2 for VM/ESA (program number 5654-010) 
VTAM Version 4 Release 2 for VSE/ESA (program number 5686-065). 


Publications are not stocked at the address given below. If you want more IBM publications, ask your IBM representative or write to 
the IBM branch office serving your locality. 


A form for your comments is provided at the back of this document. If the form has been removed, you may address comments to: 


IBM Corporation 

Department E15 

P.O. Box 12195 

Research Triangle Park, North Carolina 27709 
U.S.A. | 


IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. 


© Copyright International Business Machines Corporation 1984, 1995. All rights reserved. 
Note to U.S. Government Users — Documentation related to restricted rights — Use, duplication or disclosure is subject to 
restrictions set forth in GSA ADP Schedule Contract with IBM Corp. 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Contents 

INOUCOS: oe hr cee Hope aed. we. ieee cero B® Sicua gates Us XXXVii 
Programming Interface Information ................... 005. XXXVI 
Trademarks ............ Pedesnt am goths tet tn Be oh cdey en de 20 ae es a XXXVili 
About This Book .............0.. 0.0.0 00 02 eee XXXIX 
Who Should Use This Book .............0... 0... 00002 e eee XXXiX 
How to Use This Book ............ 0.000.000 ee XXXiX 
How This Book Is Organized ...... 2... 2... ee XXXiX 
Terms Used in the VTAM Library ............... 0.000000 eae x 
Symbols Used inthe VTAM Library ....................00.. xli 
What Is New in This Book ...........0..0.. 0.0000. eee ee xli 
Network Dynamics ..........0 2.0.0. 0c xlii 
Operator Interface Enhancements ..................0 0000. xii 
Performance Enhancements ............. 00.000 ee eee xiii 
Problem Diagnosis .......... 2... 0. cee xiii 
System and Configuration Management ..................... xliii 
VM/SNA Console Support (VSCS) Enhancements ............... xliii 
Usability Enhancements to This Book ..................004. xliii 
Where to Find Information about VTAM ................0 00000. xliv 
Part 1. Diagnostic Techniques .................... 000.0000 eee 1 
Chapter 1. Diagnosing VTAM Problems: Where to Begin ........... 3 
Determining Whether the Problem Is VTAM or Non-VTAM ............. 4 
Common Problems and Symptoms ........... 0.0000. eee ees 6 
Common Problems in Subarea Networks .................000. 6 
Descriptions of Common Problems in Subarea Networks ............ 7 
Abend 0C4 Occurs inISTTSCPF .............. 0.2.0.0. 00058. 7 
Line hangs in PALNK status ........... 0.0.0... 00 ee eee 8 
LU Hung in PNFYx State... .. 2... 2... 2 ee 8 

Message IKT0291 (Return Code 061001) Received with TSO Logon Failure 
(MVS) <2 2é¢e%@¢ 0c ¢n 794 2046-4 on GOES eS bd ee & we eS 9 
Message IST2591 Received with INOP RU ................... 9 
Message IST2591 Received and Sessions End Unexpectedly ....... 10 

Message IST4671 Received with CONTACTED ERROR TYPE 05, 07, 08, 

OMOBE vse ote os, he ld Ge ae a ee Ps a a ee ee Ea Bs 11 


Message |IST489! or IST1272I Received When Activating a Major Node 14 
Message !IST530! or IST12781 Received with GUNBIND PENDING or 


Session Hangs in PSESEND State ..................... 15 
Message IST530I or IST12781 Received with NUVT PENDING ...... 16 
Message IST530I or IST12781 Received with Pending DSRLST Condition 17 
Message IST663/ (Sense Code 08210000) and cannot logon to CICS .. 17 
Message IST663! (Sense Code 08610000) and IST2641 Received for 

Undefined COS Entry ...... 0.2.0... 000 ee ee 17 
Message IST718! and IST7191 Received when Activatinga CDRM ... 18 
Messages IST154l, IST5611I, IST999E, IST566I, and IST9301 Received for 

APPL-APPL Storage Expansion Failure ................... 19 
Missing VTAM Trace Records (MVS) ..................00.4 19 
Partial Input for TGET Received by TSO (MVS) ............... 20 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 | | | fil 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Sense Code 08010000 Received with CINIT Failure ............ 20 
Sense Code 081C0008 Received on ACTLINK (VM) .......... ‘oe 21 
Sense Code 081C000C Received on ACTLINK (VM) ............ 21 
Sense Code 083500xx or 08210000 Received with BIND Failure ..... 23 


Sense Code 800A0000 or No Message, and Sessions End Unexpectedly 24 
Sense Codes 10030000 and 08090000 Received when Activating an NCP 25 


Session Failure with Sense Code O888000x ................. 25 
Common Problems in APPN Networks ................. tote ty oh fs 27 
Descriptions of Common Problems in APPN Networks ............ 28 

Message IST4891 or IST1272I Received during Session Takeover .... 28 

Message IST663!1 (Sense Code 08610000) and IST264I Received for | 

Undefined COS Entry ....... 2.0... 20.0. ee 29 

Messages IST1097I and IST1280I (Sense Code 08A00005) Received with 

CP-CP Session Failure .......... 0.0.0 cee ee ee eee 29 
Messages IST1110I and IST1112I Received during CP-CP Session 

Activation Faure. 486 vw ee a ke AH Oe ee ee he eee 30 
Messages !IST1110! and IST11131 Received during CP-CP Session 

ACUVAtION:FANUKe: seco orks kh eh Se Be Soe a ee BE ee ae 30 
Messages !ST1110! and IST12461 Received during CP-CP Session 

ACUVAUON FANUKE fein % fe ee Oo Foes es BP ee a Be Ere eae 31 
Messages IST11101, 1ST12461, and IST1280] Received during CP-CP 

Session Activation Failure ........0.. 2.0.0... 0. eee ee eee 31 
Messages IST1110I, 1ST12801 (Sense Code 101E000A), and IST1356I 

Received during CP-CP Session Activation Failure ............ 31 
Messages IST1110I and IST12801 (Sense Code 08910006) Received | 

during CP-CP Session Activation Failure .................. 32 
Messages IST1110I and IST1280I (Sense Code of 08B50000) Received 

during CP-CP Session Activation Failure .................. 32 

Resource Not Found but Resource Exists in Network ........... 33 

Sense Code 08210002 Received with Session Activation Failure ..... 33 

Sense Code 0821000A Received with Session Activation Failure .... 34 

Sense Code 087D0001 Received with Session Activation Failure .... 34 

Sense Code 087D000A or 083B0001 Received and Session Lost during 

‘TAKOOVG!. << acs) ow 6 4 4 Gos wae a ang Ae ae ee ee Oe Se eS 35 

Sense Code 10145046 Received with Session Activation Failure ..... 35 

Sense Code 80130000 Received with Session Activation Failure ..... 36 

Sense Code 80140001 Received with Session Activation Failure ..... 36 

Sense Code 80140002 Received with Session Activation Failure ..... 37 

Sense Code 80140005 Received with Session Activation Failure ..... 37 

Session Established with Non-Local instead of Local Application Program 38 

Session Did Not Take the Best Path .................00.. 38 
Common Symptoms and Associated VTAM Problem Types ......... 39 

VTAM Internal Trace (VIT) Analysis Tool Problems (MVS) (VM) ........ 42 
Checklist for Isolating the Problem ................. 2.000005 42 
Common Symptoms and Actions ............ 0.000000 eee 43 
Documenting an APAR for VIT Analysis Tool Problems ............ 44 

VTAM Dump Analysis Tool Problems (MVS) .................... 46 
Checklist for Isolating the Problem .................+.00004. 46 
Documenting an APAR for Dump Analysis Tool Problems .......... 46 

Recommended Documentation for VTAM Problems ................ 48 

Submitting Problem Documentation .............. 0.2.00 08 eae 53 
Submitting Documentation (MVS) ............ 0.2.00. ee ee 53 
Submitting Documentation (VM) .......0.0.0 00.000. ee 54 


IV VTAM V4R2 Diagnosis. LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Submitting Documentation (VSE) .........., 0.0.0... 0 eee ee 55 
DUMP OUIOUE, 10-6 saw eo 2G Out S o Oe eL ESSE OHS SA eS 55 
Power Queue Output... .. 2... 0... ee 55 

Chapter 2. Collecting Documentation for Specific Types of Problems .. 57 
Common Problem Determination Procedures ................... 57 

Abnormal End (Abend) (MVS) (VM)... . 2... 2 ee 58 

Program ‘Check (VSE). 465.4.4<¢5 44% 46544 P4a¢404 be S44448% 63 

Wale gtd Ge 44. ee oe eS ore we eh ee at os 67 
VIAM- LOCKS: 23% .4444 29:5 eee he eee ee Eee bMS 80 
Using the VARY INACT,FORCE Command ................. 83 

BOOD. ch sit ew apticd & Edict, 34 Ue See Oe Oe th Ee OO SE Seas 86 

Message Problem ........ 0.0.0.0 0. ee ee 93 

INGOrECt OUIDUE. 6.2% 3% 64 6% de eee Se ow Ree Se OE CO GES 96 

Performance Problem ........... 0. 00 0 ee ee 101 

Storage Problem Procedure (MVS) ............... 0.2.20 008. 105 
Procedure StepS) sk A eK ee kG ews 105 

Documentation Problem .......... 0.0.00 2 ee 108 

Falling: MOGuUIG:: «225065434 bh ooh DRESS BESS ER EE SEH 109 
Symptom String Structure 2... 2. 111 
Reporting the Problem to IBM... 2... 1... 2 112 
Chapter 3. Collecting Documentation for TSO/VTAM Problems (MVS) . 113 
Initial TSO/VTAM Problem nee enhan Ba ase: Elder ae 8 ee eS 113 
LOGON PIODIOMS:. sina.& ¢Steee & ee a Ow ee oe he ee SOR UE en 114 
TSO/VTAM Abends ..... 1... 2... 0. 2 117 

ABENDOAB: ga godt -dre ee & Sea ae Pe OE Ee Ae 117 

ABENDOAG. 2266 488248 ¢Ue 64. 2 Bien de eee Bae eee 4 OES 118 

ABENDOAD:  .24.44.6 HeGe ncaa as oe Yo eS ae le Se 2 119 

ABENDISD” 6s aud he & dalam bred GW RE ee eee ee eS 119 

Hung Terminal Problems ........,... 0... 00 eee eee ee 119 
Incorrect Output Problems ...........0. 0.000 eee ee ee ee 121 

Screen Management Problems ................ 0005 ee ue 121 
FUNCHOMENOR © «is ak OSG oo Oe ReneS ee he Sg eee etens 122 
Exception Responses ........... 0... pee ee ee 122 
Extra or Missing: Data. i.4 664 « bb he Shoes a OS LES EDS SSH 123 
Data Is Misplaced on the Screen or Page ................. 124 
Data Appears To Be Translated Incorrectly ................ 125 

Screen Size Problems ............ ee ee ee ey ee eae 126 
Screen Is Never the Expected Size .............,..20005 126 
The Screen Is Not the Expected Size forthe Mode ............ 127 

Performance Problems .......... 0.00: ee ee 129 
Chapter 4. Collecting Documentation for VSCS Problems (VM) ..... 131 
Documentation You Should Collect for All VSCS Problems .......... 131 
General Procedures to Diagnose Hung Logical Unit Problems ......... 131 
Determining Device Characteristics ..............0 00050 eee 135 
Determining VSCS Module Levels ............... 2.000000 0 8. 136 
Determining the Status of a VSCS PrinterLU  .................. 138 
Operational Differences between VSCS andCP ................. 139 
Symptoms of VSCS Problems ............ 0.0.00. eee eee 141 
Overview of Normal VSCS Initialization Process ................. 141 
Initialization Problems ......... 0.0... ee ee 143 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Contents V 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Initialization Never Completes (A Wait Follows Message DTICO1I or 


DIIS/4W! gph Ka eee eS Boe ee ne ok Ss a ea ee ee 143 
VSCS Terminates Immediately upon Starting ................. 145 

A Loop Occurs during Initialization ..................0000., 148 
Other Initialization Problems ............... ee ee ee ee 149 
Termination Problems .........0.. 0.00 eee ee 150 
Termination Never Completes ............. 0.002 ee eens 151 
VSCS Terminates Prematurely ............02. 00.0.0 000000. 151 
User's Session Terminates Prematurely .................0.0.. 153 
Operator Commands Terminate VSCS Unexpectedly ............ 154 
Other Termination Problems .............. 2.00004 ee eee 154 
VM Logo Problems on an SNA Device .................0006. 154 
LOGOM:PIODIGMS: -2.s.0 ¢as oe k dd eee PS Be ek BR ache e Oe SES 157 
Logoff and Disconnect Problems ..............0.. 0.005. eeu 159 
Wait and Loop Problems ............ 0.00.0 eee eee een 159 
Preliminary Procedure for Problems Involving All Logical Units ....... 160 
All VSCS LUs Are Hung or Slow (Affects Logons and Current Sessions) . 161 
Presentation Services Is ina Large Enabled Loop ............ 162 

One or More Logical Units Hung .................. 00.0004 163 
Getting the Required Documentation ............... pas Gad. A 164 
Determine When the Hang Occurred .................46. 168 
VSCS Operator Commands Do Not Complete ................ 175 
Message Problems: Message DTIS99I Indicates a VSCS Internal Error ... 176 
Incorrect Output Problems ............. 0.00. eee eee eens 178 
Storage-Related Problems .............. 000 eee ee ee ees 179 
Performance Problems ..... ON vi ade Lah ee. Ph Geo he, he ecb Ga ee Ok es 182 
Other VSCS Problems ............. ee ee ee ee ee 183 
CHANGE Command Not Working ............. 0.0002 eee 183 
SNA DialiProbleMs: =. 44k S 423% 4,6 oo 4.2 eek eRe be ed 184 
Printer Sharing Problems ............0. 0.000 eee eee nes 185 
Operator Commands Are Rejected ................2.0.0004 187° 
Part 2. Diagnostic Procedures............ 0... 189 
Chapter 5. Using DISPLAY and MODIFY Operator Commands... ... 193 
Using VTAM DISPLAY Commands for Problem Determination ....... . 194 
Display Buffer Pool Use... . 1... 2. 195 
Display NCP Storage ....... 0... 0... 196 
Display Resource Status ......... 0.0... 0. eee ee ee 196 
Display Path Tables .......... 0... 0.0. eee ee ee ee 197 
Display Resources in a Pending State ..................0.4., 197 
Display Route Status ......... 0.0.0.0. ee 198 
Example: Solving Path Problems ...................00.4 199 
Display Route Test ....... 0... 2.0. ee ee 205 
Successful Route Test ......... 0... 00. cee eee ee ee 205 
Failed Route Test .......... 0.0.0 cee ee 205 
Location of Failure ina Route Test ..:.............. 1... 206 
Display Traces: <<. oedee 5 Bee Oe OS OR we we BOER ee ES 208 
Using VTAM MODIFY Commands for Problem Determination ......... 209 
Modify Input/Output Problem Determination .................. 209 
Modify Message Module Identification ...................0.. 210 
Modify NCP Intensive Mode Recording .................... 210 


Vi VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Modify SDLC Link Level 2 Test ....................00.0.. 211 
Modify Tuning Statistics 2. ......... 0.0.00 0.0 ee eee 212 
MODIFY VTAMOPTS Command for Changing Start Option Values .... 212 
Chapter 6. Using Dumps.................0 2-000 eee 213 
Dumps on MVS Operating System ............... 2.202002 ea 214 
ADENG DUMP: & a3 & pede hb oat eA eS eee So CRE eR 214 
PESEDUMID. <.c4.8 B48) Be Bt he He Bee Bk ee ee 214 
Stand-Alone Dump ...... 2... 2. 214 
SVC DUMD:: << 3.4073.4.5 sei Ot eS aati 8 te hd BSH ES 214 
Dumps on VM Operating System... .. 1... 2. ee 215 
FRSVCOUMG: ic oe beep eee 5-5 Se) eS ue BS Ee OS 215 
GDUMB: DUMP: .: = 4.44 2-44 4 oeb we CREE EEE ASS es 215 
SOUMP DUMD: a erupted ue kateries: a is: ea Shae os ee Ek ee 215 
DUMP Command ......... 0... 0. 216 
VMDUMP Command ............ 0... 00 ee 216 
Dumps on VSE Operating System ................2. 0.200000. 216 
Program-Initiated Dump .......... 2.2... 0. 216 
SDAID Dump Facility ..........0.. 20.0000 00 ee ee 216 
Stand-Alone Dump Utility ................ 0.0.02 0 0000845 216 
DUMP Command: = 423 2.024 Ba Rh end EE SHEERS HSS 217 
First Failure Support Technology (FFST) for VTAM (MVS) (VM) ....... 217 
FEST DUMPS: sa f-0o oe a8.» hehe hha Soe ea 4 SEES 217 
Dump Data Set (MVS)... 2. ee 217 
SDOME  fs6 4-5 kn ata Oe ee 217 
FFSE-MInidUMD, -.2:c.0o%4¢8- 34 nae ee eho 4 ere? ee Ree we 218 
The: GOnenC AIS 4 hk he A ee a bw Ee es 223 
The Symptom String ......... 0.0. cee 224 
FEST GONSOIS: ig 626 cence Sexiness wee esd ae ee Rok Oe lene See 224 
Using the Trap Module ...............0 2.0.00 20002 eee 226 
APPC Sense Code or RPL6 Slip Trap (VM) .................. 226 
Reportinga Problem .......... 0.0.00 eee ee 227 
Network Control Program (NCP) Dump ...................0.. 227 
When to Use the NCP Dump... ...... 2... 2... ee ee ee 228 
Using the NCP option on MODIFY DUMP ................... 228 
Using the Independent NCP Dump Utility (Channel-Attached Controller 
OI a be ond to Gs cas hee ae ee ee Gn Be Ea a ws 230 


Communication Scanner Processor (CSP) Dump (3720, 3725, and 3745 Only) 230 
Maintenance and Operator Subsystem (MOSS) Dump (3720, 3725, and 3745 


OAV)! 45 nese tw Hons Sek 8, the en ad oe GE is Ge wt Hee 231 
Formatting and Printing Dump Output (MVS) (VM)... . 2... 2. 232 
IPCS Service Aids (MVS)... 2... 2. 232 
ABDUMP Service Aid (MVS) ..... ee ee ee eee ee ee ee 232 
PRTDUMP Service Aid (VM) .........0.. 2.00. eee 233 
SADMP Service Aid (MVS) ......... 0.0002 eee ee ee 235 
SDUMP Service Aid (VM) ......... 0.0.2 ee es 235 
Chapter 7. Using VTAM Dump Analysis Tools (MVS) ............ 237 
How to Read the Syntax Diagrams ............... 2.000000 048 238 
Enhanced VTAM Dump Analysis Tools ...................06. 240 
Using VTAM Interactive Problem Control System (IPCS) CLISTs ....... 241 
Obtaining Online Help for CLISTSs ..................0..005. 241 
Debugging CLIST Errors ..... 0... 0... 0. 2 241 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Contents Vii 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Printing CLIST Output 2... 2 2 el 242 
Sample VTAM Dump Analysis Functions ...................0..4 242 
Using the Panel Interface ............. 0.0000. cee eens 242 
Using the IPCS Command Line ...............00 000000 Gs 243 
Using the Batch Option ...... died ie By dt Sete de tech eth ee ee 244 
VTAM Formatted Dump Procedures .................-.0 0000s 245 
PU. tus ate ho ee ae ho ce 2 oe a Re ee Se See 246 
ODClANGS: waa. Se CES DY CRS SE OO SS Ke Ses 246 
SVAN sete Het eh ae cats Ss A eas Ge ae Oe ee 246 
Sample Output forALL  ... 2... 0.0... 0... ee 247 
BPPEGONY.  t-ssetctin.g ee he ee @ Ue Be be Se ee 248 
ODEranNGS:. «sets apa te bd oe BE Ee eee ee oo A 248 
Sample Output for APPLCONV ................ in hn 6 248 
APPLMODE. <6 «9 & have bee eo ah bee ee el he ee ee 249 
ONEFANGS, 938-4 6 eee hae Ee EE ERS Ow ee 249 
VIAN edie ye Be. Se Br eG, Oe ee ee hea os wet 3 ee 250 
Sample Output for APPLMODE ................... bh eae 250 
APPMODAL.. 3245423544084 G 8M ea S83 ao we hes ee a eh 251 
Operands: 04.4.4 % 44.866 & Cb eye Oe oS See fe oe ee 8 251 
DVINGM, of f05% 4 o ese Bk oe Cae ee ee SE 252 
Sample Output for APPMODAL ....................... 253 
APPNBASE. 3 246 bh ee e-e eee GN S16 EOS HES BENE GREG 254 
Operands: -2.6 «4.4.5.4 bd eee Oh orig de BO RS AEE ES EA GS 254 
SYRIA. 225 S$. doe Ae ae ed, oe ee Pere e ree Te 254 
Sample Output for APPNBASE ..................0004. 255 
FINDDSIB. ° gut 22 eae ao ee oe ee ee SS EE GENES ER ESS 256 
ODGRANCS: <6 2 eh 4 c-0 bat ed eine Sars ew ad EEE OEE oS we o 256 
SVN: og ee eae ee ee, SEA ee ee 6 oe 257 
Sample Output for FINDDSIB ................. 00.005. 257 
FINDSIBS , scyecatd eo 6 et etree So was Gar ee ae aS 258 
OperanOs: <4 so 2h 248 3 ere ee ee ee Be ew ee we 258 
SYVMGX. 22 Soa Ce eae ORG ee Boe eS ER ESS 260 
Sample Output for FINDSIB ................. 00000008 261 
FNDADJGE cava ek ook Oe e ee Ow oe eee eo Hs wh es 262 
Operands aa. 563 284 6 oS KR GE e be e ere ee OE 262 
Syntax ........ Mek aoe Bahan Soe eis he beg ee aha Bk, 262 
Sample Output for FNDADJCP ............. 0.2.00. 0058., 262 
FNDANDGB= ve: dedwen xt ak See Se Brb ee bo eee a a eh a ed 263 
MODETAINGS: as oo iia sence Se ea OG ete I A ee a oe Me 263 
VIN 28 a Ge tee ds fe eh bes a Rw oe oe ee a eS Oe SE, darts See tee 263 
Sample Output for FNDANDCB  .......... 2... 0.2.2... .008., 263 
ENDGOS: -4,< ocd oo Ou OS Sees Hoe Bie 2a ew ol el a 264 
ODGIANGS:  egiie tose ee ee eta e ©  Bglay Gs Ae ee Gos 264 
DVNIAXS ne Se ie lo Ba SR eee Bea oe Ae ee 264 
Sample Output forFNDCOS ..................... 000. 265 
PNDDECS: 5.2% ¢3 us AREA Dw Ree oe SEG See eh 266 
OperandS: G24 6 4b ORAS AEE Ree Eee eK ERS EES MS 266 
SYMOX se aed wes EASA ORAS SH ESE Aw eS 266 
Sample Output for FNDDECB ................... 0.004. 266 
PNDENDEL. 4.4 do fachiah ehawe Deh ES AMER e ess 267 
OOGANGS: eee cae he She oY ERE ELAS Rh Oe ES 267 
VINA, hiss beeen Ee ee ee Gees, oes see wh gs a e-Book 267 


Sample Output for FNDENDEL .....................0.4. 267 


Vili =VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


FNDECB. wwe d.6k eS ae Sete ee a8 ae eee ee be BR ee 268 


OOGands: 2243 Hee ek a ee Ee Ee S 268 
SVNOX gute tbe bole & Dace Se ee ee eee, eB e es 268 
Sample Output for FNDLCB .................. 0000004 269 
FNDNDREGC: 9244.66 o52 eek Sua eb Oe oe ee Ree Re eh eS 270 
Operands: 22 6 24h eb oR we BES AGES SERS SESS SHES ES 270 
SYMON. 4 645-b eA Shee Ee Oa RR ews BE eS oe 270 
Sample Output for FNDNDREC..... i She ie ath oe a A GO 
FNDNODE: 2.2460 3%344 ted $4406 os BESS Oa ee eee he 271 
OBGIANGS. oc 6-0. 4.5 oe ee ees eee ee ee ee 271 
SYNE. 2.446489 &S canada ede Foe ee ES ee 271 
Sample Output for FNDNODE ....................2-.. 272 
FNDREREGS. «2242442 $4 t.4 be dhe bd REDE ADEEEST OE Ra DS 273 
Operands, sci ba i ee ee Bo ee ee ee 273 
Oh 2): ee a ee ae ee ee ee ee ee ee ae ree eae 273 
Sample Output for FNDREREC ....................... 273 
PNOSCGB: -24.4.¢4¢44:6 £22 eee es CED EESE She EME wee ad 274 
Operands; 2.65. $.4.2 6 £5 3 ei bh ee oe BS EES PR EERE 274 
SVINOM a2 iid bw oe SBE one oO a ae eee ae 274 
Sample Output for FNDSCCB...............-.-2. 00004 274 
PNDSITCB: gctctow-e-% ave & each oa eee ee be ee ee 275 
OVCrAnds.. sere ov os Gch RO eek eS CREME aes he ee 275 
SVGMEN: sfeccteo he i Pe ae Le ee he we ewe ee 275 
Sample Output for FNDSITCB .................. 2.0000. 276 
ENO TGREC: 125.6 hot Oi ie eins ese a ee to So ee GO 277 
OPErANOS: cw « am boo ABLE aa dee eh ee EK ow ewe OR BS Ae 277 
OVI oct cays a AIS ee ain deta Ope ae Sa ah eae Ge eo BN ee 277 
Sample Output for FNDTGREC ................-..000.. 278 
OSM seca: ae oe ae Gg ay ae eee ee te ee ae eee 279 
OPGialGs. 2444) tek bP eee eG ee ee 279 
SVINGX: 2b u-o ee ea ah Reece ete ee eee ho ee he 279 
Equated SYMDOl 4 25.8.6. 8.4 bck ch Bee ee eho Re 279 
Sample Output forHOST .............. 2.022.000 002 G 279 
IST VAGND: 26 sn-$6 4 oS ESS ed OE She ew He GR 280 
SVMNAX: 2284 Sek baw ees CSS aSs ee ee Ae Ae ees Ss 280 
equated Symbols «0844460645644 060 8 ee bo ee eee s . 280 
Additional Information ....... doch. oh Bidet OU ee, Bese eee ee 281 
Sample Output fom ISTVABND ...............-..-.-000- 282 
ISTVDUMP 1.44.4:6:4 Gin wis eee be ie ee ee Roe ea 283 
SVMAN cede e $4.84 Bee Dek RAM OES oe eee ee 283 
Additional Information ........0.. 0.000002 eee ee 283 
SDUMP Parameter List ...... Ao ia a chee ae ee 284 
Sample Output fom ISTVDUMP ........,...........0004 285 
IST VIMAP do be eee BES ee ew ne ee en er eae ee ee 286 
SVN fb exces ass. dee oS ee AS Ge eee & ea ae 286 
Additional Information ........0.0 0.0.0 000. ee ee 286 
Sample Output fom ISTVMAP ............... 20004 2 eee 287 
IST VSAVE: dus Bechaae OSs Gch Og ks A Hee wie ae acca we le Se 288 
Operands: -§ 08 i be Ge edie oe ee ee ee 288 
Syntax ............ Bes Barus EOE, Bs Pug aie nto eee wai ate, Oo 288 
Additional Information ........0. 0.0.00 eee 288 
Sample Output fom ISTVSAVE ............. 2.000052 eae 289 
ISTVOWIP! feces 64 oe hele 8 ee Se ee EEO Ee 291 
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Syntax ........ MAREE AGO ERG See ae ee He 291 
Equaied Symbols 44445246 2686-63468. 4 $¥ ee 544 oe os 292 
Additional Information ................. 0.0... 000004% -. 292 
Sample Output fom ISTVSLIP ................... 2.00084 293 
PABSCAN..... id oh See te oh ey HE Ce A ee ee oe ee Oa 295 
Operands ................ ee ee eee ee ee 295 
Additional Information ............. 0... 0. eee ee ee ee 297 
VAN gs esc ae a de, nae We ee Sh a Bc ee Gd ee ee 297 
Sample Output for PABSCAN ................0.020 0088 298 
PARUNGER? Se BS eae a Se © ae By eh we i ce te 299 
ODGIANOS:. 62S eo BOE Ee hee ow Uh eo eae a 299 
SVAN. ak Behe gene ee Ja a ae a See we ee et ee ge at Genet 299 
Sample Output for PARTNRLU ..............2.....0004 299 
ADICHECKR 24 sav 444 eee ee OE ALG Daw Seb awa heed 300 
Operands: 6-6 aacem & i bea SO Re ie Sw Oe we Ss 300 
SVMS fie Bo bee ee ae ee ee Be oe eee aed & Bee 300 
Sample Output for RDTCHECK ....................04. 301 
POURS oo iat. Sk Ok, eerste ae Bi oe Ete A SG ee este bb bce HG 302 
OpERANdS: eo Oe BBs oe pee Soar & Oe es Oa SE 302 
VIM, cee seagesaeas a he A Ee vest, rc cfc Waly a ee At he we we 302 
Sample Output for RDTFULL ......................004 303 
ADTIAIER: <os.5 ob & ao» orale tw ola he yee be ele oe ae oe Bad 304 
COCTANGS! . fa Stk Gn ba eS eS ore Se se ED Be ee 304 
SVM o.28 f5-04 242 Bes oe ee ee ea oe oe 304 
Sample Output for RDTHIER ..................0 0000048 304 
ADISUM: aim eawsoe bend aBthe-dat ea ee S46 wee ee ee aS 305 
OpGManGS:. ch 6.60% odo Ree Bk ee hae ORME EEE ES SS 4a ek 305 
SVOAM. 4 tee, ho Se ahd oh eS oH GSS ork Pw eared 305 
Sample Output for RDTSUM .................2.... 00048 305 
ROUTES: ses. 6d ed ete Se BS eee ae is a ek . 806 
OperanGS. <4 aldo & ah he a ot he ete ee ee oe Bd 306 
VINA, cae Seth tnd e , & uh ec ee Wt A ee Se ee Ge 4 SS 306 
Sample Output for ROUTES ..... be heme oh oy de DG. Bee ee & BAL wed 306 
EOS fee a esse &. Go eee ee iene i ee Ee WO BD ve oe Be 308 
ODGIANGS. cg esck ce 6 AGA es DH Rah d Se bb SER OEE BEY 308 
SVEN 45d ea eas, Sd he de orig oe OR a ee oe BG Ge 308 
Sample OutputforSES ............. 0.2.00... eee 309 
SIDGHEOK. oy slew die Bhat es ae ce ee ee a 312 
Operanes: 6.6.46.%4.4 6.40 ab oS 2S Oe BES LOSS EEE EES 312 
SV MMe eae te fe eis ts eh ee tee ee eee ee er 313 
Sample Output for SIBCHECK .................0.0 00048 313 
SEPANG? 2.493448 oo ta hee ee ee SG ee Pe ee Bs, da ta de 314 
ODGIANGS: 64:3 GAK oo a eek Re oh Se Be ee ae 314 
SVM? co a es Be ES a we Seek RE Ba ok BS 316 
Sample Output for SPANC .............. 2.0000 316 
ORIN he varat a Ao SS de Ge oF ener Bi hee evened he a ee ee ew 318 
ODCIANOS: se ecicjee there Ww Got chia BORE A Be ee ae at 318 
EQUaAIED SYMDOIS. a ies. Rb et aes Ae He a Bee ae es 319 
OVI “ie: geod dk Bees peerage Ge Ge Ge spe te ue oat ES ae ee ee . $319 
Sample Output for SRTFIND ................. 0.000006 319 
SIORAGE: ivccict.6.oes Geet ela ie Ge ie ee Gat Got Sa & ewe ees 320 
Operands: 3.4.46 bp dhe RS oO ES OG EEE ARE EY he es 320 
DYMO 35. yas Seder ee Ree we Ears Lee hee So 320 
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Sample Output for STORAGE ....................004. 321 
MT. 2225 Gee Sh Breeden wee en ie el lates es Bac he a eae yw! ee eh eter ac 322 
ObGranGSs: 42234224546 65-6 he eee Be eee tb eh Se ees 322 
SIME fee pve Set a oa as es ate ee Gere cre ay ee ce ee dno 322 
Sample Output for VITAL... 2... 2. ee ee 322 
WUAW) 2s S ae oe eS ee Re ee Oe ee Oe Ye ie ae 323 
Operands: 6054.3 eo ES he A RSS SERGE ASH 323 
DVOION- 76 He eee ESE EME LOE OH SS GE Dawes 323 
Sample Output for VTAM ............. 000.002 eee ee 324 
VIBASIG? eu d:c ce eked Gis aries on oo Bohs BS ed ee ees 326 
ODGIANGS: + ca. & eve tics ere ee OR ee Se OSS Be Se 326 
VINO. 4: kek ses kG ee oe GB Se eS ee ee Pe 326 
Sample Output for VTBASIC  .............. 0.0.02 2 00040. 326 
NABWS. 2 ak aot Ge ork eS ea he ss. BAe ee a ee et ee 327 
Ooerands: 24. foe Se ea we US ee Go eee we & Boe Jed odes 327 
Equated Symbols... 2... ee 327 
DVMMGK: ooo eee ae eee ce ee ae ea ee ee oe Se Be es 328 
Sample Output for VTBUF ............... 0.0.00. 0 000. 328 
VICVEPAB. 44-0244 026 8G oh aew hes dock ads Gen Mane Geel ae d 329 
OpGIanOS: os a hte wee Se SS Si sip Ge oe St he SH Sp wo Sere: 2 329 
SVIMAM, Ge ald cee Bre ed Se Be BS EE EEE OO BA Oe SR eS 329 
Sample Output for VTCVTPAB ............... 00.0002 ee 330 
VIFNDMOD: a4-c-3 553 SS arek SORA RA ESE RE £4 GREER 332 
OOMErANGS: 5.4.6 24 ee ee & ESS ore ee oes A ee ESS Sees 332 
equated Symbols: 2: a4 Ache Bet S ee ee So RRS 332 
SVUNAK. hain ee oh eae Gee Ce a ee ee ee ek ee 332 
Sample Output for VTFNDMOD......... 1... 2 ee 333 
VIMODS? 26:3 snc & eis A ie ES eR OS 8 Sk ee 334 
: Operands ..............0000058 ie ee Oe 334 
EGUAICA SYMDOIS: eseccie beter wa Se es a oe EE A 334 
Additional Information ........0.. 0.000 2 ce ee 334 
SVOIAN a enna ddd ark biped. & oh re ects Gren ae Se SEE wad As 335 
Sample Output for VTMODS .............. 000.02 eee 335 
VINODE < 4% 58¢ 4244 Petes iu ees Se ee ee re 336 
Operands ....... ik BOM Deine See ae ee ae ee 336 
SVEN, 4 Peewee ee Oe ee RSS ae eee PE aS 336 
Sample Output for VTNODE  ....... 2... 0.2... ee ee 337 
VIREADYOQ: 24.66. 6:54. os Bote de oe. Gree eo ROS Bor eee 338 
OberanGSs. 2. 6.45 e eS 6.4 CR Bee ee AS Ee 338 
SVOIEN: 2:5 4 ere ae en es CE eee EA Ge a eee 338 
Sample Output for VTREADYQ......... 2... .. ee ee 338 
WIEN. 2 4 aa ee ee Ge Oe oa ee ee ae 2 339 
ODEKANGS: «titan eee EG & Wiehe ee ait eo ei he GS ws Se Be 339 
VIE see SB eto hi ee ee en oh we Se ee 339 
Sample Output for VTRPH ............ 0... 00002 eee. 339 
VIVID. ot eo ah bh be, be ea ee ee Be Ea Bk hd 340 
ODGTANOS” ie riis yh os Pe ne A ak ee i Be ee hs 340 
Equated: Symbols 4 j.64 #4: Gud a8 # cence d Bee eet ae hewn Ho 340 
Additional Information ........... 0... 000 eee ee eee 340 
OVNIAN: 34.2 6.2 bos ors a eee be eh Oe he Sve ot eS 341 
Sample Output for VTVIT ..........0...0.... 022.0004 a... 841 
VEVABEK. - 2.6.6: 4:65 & wwe baie 2 yO eee Bt SSE a 342 
ODCIENGS: xo .6i:8 tS ek ie eas eA BR Se Oe ERNE 2 342 
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Additional Information .........0.. 0.000.000 2 eee eee 342 
VMN ay ati Aca ee -e a ae e ae ek  e e e ee ee 342 
Sample Output for VTVRBLK ........... Sie hee Bae Be Gated 343 
MAN Sep thers he tee a: bra ee a en oe a eee 2 od He 344 
Operands: <.i:24¢.6 8 beth d ed & Db Eee eee hee de Sth cna e 344 
SVRIEX. crew eda Eee awh dhs hehe chee hoes bee 346 
Sample Output for VTWRE .............. 0.0.00. ee eee 346 
Chapter 8. Using Traces ............... 0.0.00. eee 347 
Traces Provided by VTAM..... 2 ww 347 
Activating Network Traces .. 1... 0... 349 
Starting the Generalized Trace Facility (GTF) (MVS) ........... 358 
Collecting External Trace Data (VM) ....... 1... ... ee eee 359 
Virtual Machine Tracing (VM) ................ 0000005 .. 360 
Formatting and Printing Trace Records .................... 361 
USING:ACEITAR ii geo Spee ke od, ee Ee OS RS 361 
Using IPCS with GTF Trace Option (MVS) ................. 362 
Using TRACERED (VM) ......... 2.2.2... eee ee ... ©6363 
Using TPRINT (VSE)! ( g0554 4.6 8 SS we bE eee Ea 363 
Using DOSVSDMP........ 1... 366 
Trace Output: 32d oc nw we he rk we Be Se ek He ee oe ed 367 
Buffer Contents Trace .. 0... 0. 369 
When to Use the Buffer Contents Trace .................. 370 
Buffer Contents Trace Operation ..................00004 371 
Buffer Contents Trace Output .................0.0000. 371 
VO Trace ....... Se cGycip $e. Bo oes TP aes Bh Al eased gin 4 0h <gtahts > alps We, de eae a 373 
When to Use the I/O Trace ............. 0.0.0 000 eee 374 
/O'Trace Operaiion. sc he oe OR BEES Oe OEE SS 374 
/O Trace Output (MVS) (VM)... ee 375 
VO Trace Outout VSE) asa 234004 be OAS eh iio nS Sor ee he 375 
AnyNet I/O Trace Format for SNA over TCP/IP (MVS) ..... Cone eae 376 
SMS (Buffer Use) Trace ........... 0. 000. eee ee es 377 
When to Use the SMS Trace .................00020004 377 
SMS Trace Operation ........... 0.000. eee ee ees 378 
SMS Trace Record Output (MVS) (VM) .................04 378 
SMS Trace Record Output (VSE) ..................000. 379 
TGET/TPUT Trace for TSO/VTAM (MVS) ................004. 380 
When to Use the TGET/TPUT Trace .................... 380 
TGET/TPUT Trace Operation .....................0.. 381 
TGET/TPUT Trace Output ........ ee ae ee Se ee ee ee oe 381 
Traces Provided byNCP ...... 2... 384 
Generalized PIU Trace ..... 2... 0... 384 
When to Use the Generalized PIU Trace .................. 384 
Generalized PIU Trace Operation ...................0004 384 
LING -TiECO. -h 4g ks 44. 6 eek & oro ee oe SE Bh Ds Se 385 
When to Use the Line Trace ................. 0.2.00 04 385 
Line Trace Operation ........0.0.0.0 0.000. ee es 386 
Line Trace Output (CS Type 2) ..........0..0. 0000000. 386 — 
Line Trace Output (CS Type 3) ..................0000. 388 
Network Controller Line Trace (3710 Only) ........... ee ae 389 
When to Use the Network Controller Line Trace .............. 389 
Network Controller Line Trace Operation .................. 389 
Network Controller Line Trace Output .................... 390 
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Scanner Interface Trace (3720, 3725, and 3745 Only) ............ 390 
When to Use the Scanner Interface Trace ................. 390 
Scanner Interface Trace Operation ..................04. 390 

Transmission Group Trace ...........0. 0.00000 eee ene 391 
When to Use the Transmission Group Trace ................ 391 
Transmission Group Trace Operation .................0.. 391 
Transmission Group Trace Output (MVS) (VM) .............. 392 
Transmission Group Trace Output (VSE) .................. 393 

Dynamic Trace Utility for Integrated Communication Adapters (VM)(VSE) .. 395 
Chapter 9. Using the VTAM Internal Trace (VIT) ............... 397 
Activating the Internal Trace .... 2.2... 2.0.00... 00000000 2 eee 398 

Selecting Trace Options ..........0 2... 000. 398 

Internal and External Trace Recording ..................04. 401 
Recording Traces in Internal Table (MODE=INT) ............. 401 
Recording Traces in External File (MODE=EXT) ............. 403 

Module Names in Internal Trace Records ................... 405 

SNAP. Trace Record: ~ 6.4.46 8 «hws S42 eu ta mG HEY Ee ROS 408 

Deactivating the VTAM Internal Trace ....................0.. 410 
Chapter 10. Using the VIT Analysis Tool (MVS, VM) ............ 411 
Setting up and Running the VIT Analysis Tool .................. 411 

slept RecoraVil «26.45.4464 ee bbe wb phew RAR EEO 412 

Step 2. Setup to Runthe Tool ................. 00.0000. 412 
Create a Data Set (MVS) ............0.0.... 00.000 0050. 412 
Issue the appropriate FILEDEFs (VM) ................... 414 

Step 3. Create the Parameters forthe Job ...............0... 415 

SICDS2.AUNINEWIOD: 4c: tisals ead ae de a Rae R toe ee a ee A ~—©415 

Step 5. Check the Output... .... 2... 2.0... ee ee 416 
FROTUEN COGGS Ss osc: fie 5e ede Way eh ch eed ee dye a oe Be eB eee Hie 416 

Analyzing Storage ................. ae etae wat a Ge tare, tore Oe 417 
Matching ............ ab, Ger te Dts ie Ptah owe oes Boke a eae ta heat 417 
Unmatched Allocates ............. 00000. eee ee ee 417 
Storage Lengths ....... 0.0... 000 ee ee 417 
GBLK Pools, VTAL Pools, and REQS Buffer Pools ............ 418 
Address Space Identifiers (ASIDs) and Data Spaces ........... 418 
Parameter Syntax 2.0... 0 418 
Sample Output for Storage Analysis ..................... 419 

Counting Request/Response Units (RUs) ................2... 426 
Requests/Responses ..........0 0.000 eee ee ee ee 426 
PS. oh yee os oe Gok SS ae GA oe ew ere wowed 426 
Network Addresses ...... 0.0... 0... pee ee ee 426 
SOMING- OGG 3 arte ai aw ho ho eh ead, hea ee a Ga ae 426 
Parameter Syntax 2... 1. 427 
RU Parameter Coding .......... 0.0.00 eee ee 427 
Combinations of RU options ............... 0.0.0.0 000.4 429 
Sample Output for RU Counting ..................2.00.4. 430 

Extracting Information from the VIT ....................04. 434 
Using the Template ......... 0... 000. ee 434 
Creating a Boolean Expression without the Template ........... 437 
Parameter Syntax 2... 1 ee 439 
Sample Output for VIT Extraction ...................000., 439 

Using the Timing Options ............ 0.0.0.0 cee ee eee 442 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Contents Xili 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Salt ANG SOP TIMG® 2.4 Se ee ie He ee Ee eee es 442 
ReDON-InieiVal. 6a Behe eee he ee Bee be A Oe eR 443 
Parameter Syntax... 1... 443 
Using the I/O Options .............. 202.002 ee eee 445 
Wace Wrapped) 4 .4G¢ 455% e hee 6S Bee & Doe we ee ele oS eS 445 
POMMALOUIDUL -jw.u a Sad 4 oa EME ee a ee doe de tk 445 
Parameter Syntax .. 0... 0.0.0.0. 446 
Operands: «462-646 +28 3565 6 bbe nee hh CSO A See Ee 446 
Creating Your Own Parameter Dataset ..................44 447 
Sample Parameter DataSet .............. 0.2... 0 00008. 447 
Chapter 11. Using VSCS Service Aids (VM) ................. 449 
Message and Module Conventions .............0 00050. eae 449 
Operator Console Listing ........ 0... 0.0 ee 450 
Operator Commands ...... 2... 0.0. 450 
BFRFIFO Command: 364046 2s cao 2S ie eee a eS 450 
CHANGE Command .............5 2 eee ee 450 
DISPLAY: COMMANG: eg dc ers 4 ERS ES ee a a es 451 
DUMPLU Command ............. 000 pee eee ee ee 451 
FORCE COMMANG? va%- oie Ss ee a we Behe aoe Stn kB een eka 451 
QUERY Command: <i 2224 «444.444 %¢02554 68 3 ow eee tes 451 
STORAGE Command ......... 2... eee ee tes 452 
VSCS-DUMD: 22s 3% 6 Se & he ee AS BSE Bree Hae 453 
Dump Formatting Routine .... 2.0... 20... 00. ee 453 
VSCS Trace: FacitY: ands pe bo Sos ble ew hee ae aE ew 458 
Activating VSCS Traces ..... 0... 2 459 
Using the External VSCS Traces ............. 0.000 eee 460 
VSCS Mace lable: 2 64 eo wh ek Eo ROS SR Se eS 460 
Trace Table-HOader: ac sc on & cod Bae RS A we eR ee PS 461 
Examples of VSCS Trace Output ................. 0.00008. 462 
VSCS Trace Record Formats ............ 0.0000 ee eee eens 465 
VSCS CCS Trace Record Formats ...............00.00005 467 
CCS Trace Entry fora Logical Unit ..................... 467 
Global CCS Trace Entry .................... Fees ae eee 470 
CCS Data Trace Entries ............ 0.0.00 eee eee — 472 
VSCS Cleanup Error Trace Record Formats ................. 478 
Logical Unit-Related Trace Entry (VPUR or PBRK) ............ 478 
Cleanup Module-Dependent Data ........ Ss aE SE OD) dead. af vee aoe, ek 481 
Logical Unit-Related Trace Entry (PFOR) .................. 483 
Data-Related Error Trace Entry (CXIT) .................04. 486 
ABEND Trace Entry (ABND) ................ 0.00000 2s 488 
Internal Error Trace Entry (INTR) ...............2.2 2000. 489 
Module trace flow indicators .............. 0.002 ee ee 490 
VSCS Data Trace Record Formats ...................005. 491 
Input Trace Entry: 4.4.44. 6-4-4 oe we ae ee ole bw eb be ee 491 
OUDUL TRACE-ENUY” st. octacs bo Bde’ se Ra Seka ale ee Bae S 491 
VSCS Dispatcher Trace Record Formats ................... 492 
Dispatcher Trace Entry for a Logical Unit: Entry! ............ 492 
Dispatcher Trace Entry for a Logical Unit: Enty2 ............ 495 
Dispatcher Trace Entry for a Global Connection .............. 497 
VSCS Operator Trace Record Formats .................00. 500 
MSGS Trace Entry (MSGS) .............. 0.000000 2 ae 500 
OPER Trace Entry (OPER) eds-7<-4 «bse dowde 6 $4.534 4 es 501 
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VSCS Storage Statistics Trace Record Format ................ 502 
STAT Trace Entry (STAT) ......... 0.0.0 0000 eee ee 502 
VSCS Storage Trace Record Formats ..................... 506 
FREBS Tace-EMWy: «i442 444.4 e4 RES ES ee Goreng aw Re os 506 
GEIB: Wace EnUy” 24.06 pane # wh ce ek oe ow Se 507 
VSCS VTAM Exit Trace Record Formats ................... 507 
VSCS VTAM Exit Trace: Entry1 ................... 005. 508 
VTAM Exit Module-Dependent Data ..................... 510 
VSCS VTAM Exit Trace: Entry2 .................. 0.000. 515 
VTAM Exit Data Trace Entries ................... 0005. 519 
DIIVSENDPERQUy 4 «ce FS we BBS BH ERE ES ok EOS oes 528 
DTIVSEND. Ent 2. -i-4.54.¢8 4% 2H SS GE Ee Gee bow ko eo 532 
OTIVOIMUS w35.30 sacs em BAe ck ck Ok BS HS Gla eh darts 534 
LBCSTATE Values for PLBINxxx .............. 0.0.0 040 2 ue 535 
CONSOIG7MOdG: xc 5 io a, ech RR we a ee oe ee RE GS 535 
GMS: EGIEMOdGG. rte 3. & ota heh we he ee Ee See ee 535 
Full-Screen Support Mode (FSSM) ...................0.4. 535 
IMNGMalWMOGGS: ace 5 Scare ease eis ree Se ee ee OR ase ae 535 
WEB Function Codes ........... 2... 00. eee 535 
Function Codes for Internal States ...................04. 536 
Function Codes for Inbound Processing in All Modes ........... 537 
Function Codes for Outbound Processing in Console Mode ....... 537 
Function Codes for Outbound Processing in CMS Mode ......... 538 
Function Codes for Outbound Processing in Full-Screen Mode ..... 538 
Chapter 12. Using Other Problem Solving Tools .............. 539 
Alert Messages fom NCP ......... 0.00.22 ee ee 539 
Recording NMVT Alerts in LOGREC ...................0.4. 539 
Alerts (VM) (VSE) g.c:4 5% Be twee 6 2S et we oe eee ... 540 
LAN Alert Description Codes (VM) (VSB) cote cee wy hho hb wh ee ae 541 
Description of Detail Qualifier tems (VM) (VSE) .............. 547 
Command Values Reported in Trace Entries (VM) (VSE) ........ 547 
Messages Issued for 3745 Bus Switching .................0.2. 549 
Hardware Error Recording ............ 2.000 eee eee es 549 
Logical Unit Connection Test (IBMTEST) ................... 550 
NCP Error Recording .......... 0.00 eee ee 551 
PPOICH AIGAS. «yaa eae SS. tte eel ge ah nk hk eee ie ae eC Guu Saale 551 
VTAM Patch Area Bellies ge Ab, 2 cle teecth aig Se atl av soa ans Wt. Gy a Se ode as Six Be oad BS 551 
TSO/VTAM Patch Area (MVS) ..........0.... 2.00002 eee 552 
VSCS Patch Area (VM) ............... ee ee ee 552 
VTAM Load Module List ................. 0.0.00. 2s 552 
Using Save Area Module Linkage Conventions—Subarea ......... 552 
Using Save Area Module Linkage Conventions—APPN ........... 555 
VTAM Error Recording for Integrated Communication Adapter Lines (VM) 
(WSE)) ccna a ath hon Gece es aes aes Bi rue Baas eee gant Bete 556 
Part 3. Diagnostic References .................... 0.000000 002s 559 
Appendix A. VTAM Internal Trace (VIT) Record Descriptions ....... 567 
*“*** Entry for VTAMFFST .......... 0.0.0. ee ee 568 
ABND Entry for Abend SNAP Routine .....................0.4. 569 
ACA1 or ACI1 Entry for LU 6.2 Authorized |O or LU 6.2 TPIO (Part 1) .... 570 
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ACA2 or ACI2 Entry for LU 6.2 Authorized IO or LU 6.2 TPIO (Part 2) .. 572 
ACAS or ACI3 Entry for LU 6.2 Authorized IO or LU 6.2 TPIO (Part 3) .. 573 
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ACU1 Entry for LU 6.2 User Exit (Part1) ........... Ne a te ie 580 
ACU2 Entry for LU 6.2 User Exit (Part2) ................... 581 
ADPx Entry for Adapter I/O (Part 1) ............... 0.000000. 582 
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Notices 


Any reference to an IBM licensed program in this licensed document does not imply 
that IBM intends to make them available in all countries in which IBM operates. 

Any reference to an IBM product, program, or service is not intended to state or 
imply that only that IBM product, program, or service may be used. Any func- 
tionally equivalent product, program, or service that does not infringe any of the 
intellectual property rights of IBM may be used instead of the IBM product, 
program, or service. The evaluation and verification of operation in conjunction with 
other products, except those expressly designated by IBM, are the responsibility of 
the user. 


IBM may have patents or pending patent applications covering subject matter 
described in this document. The furnishing of this document does not give you any 
license to these patents. You can send license inquiries, in writing, to: 


IBM Director of Licensing 
IBM Corporation 

500 Columbus Avenue 
Thornwood, NY 10594 
USA 


The licensed program described in this document and all licensed material available 
for it are provided by IBM under terms of the IBM Customer Agreement. 


This document is not intended for production use and is furnished as is without any 
warranty of any kind, and all warranties are hereby disclaimed including the warran- 
ties of merchantability and fitness for a particular purpose. 


Programming Interface Information 


This book is intended to help the customer to diagnose VTAM and primarily docu- 
ments Diagnosis, Modification, and Tuning Information. 


Warning: Do not use this Diagnosis, Modification, and Tuning Information as a pro- 
gramming interface. 
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About This Book 


This publication is intended to help system programmers in a VTAM environment to 
diagnose problems with the VTAM program. 


Who Should Use This Book 


System programmers should use this book to analyze a VTAM problem, classify 
the problem as a specific type, and provide information about the problem to an 
IBM Support Center representative. 


You should be familiar with VTAM's service aids and the procedures for reporting 
problems to an IBM Support Center representative. You should also be familiar 
with the new functions in VTAM V4R2 that are described in the VTAM Release 
Guide for MVS/ESA, the VTAM Release Guide for VM/ESA, and the VTAM 
Release Guide for VSE/ESA. 


How to Use This Book 


Use this book to isolate and identify problems with your VTAM network and to 
collect appropriate documentation to resolve network problems. 


Use this book in conjunction with the VTAM Overview for VM/ESA and 
VSE/ESA flyer included with this book. 


How This Book Is Organized 
This book is organized into the following parts: 


e “Part 1. Diagnostic Techniques” on page 1 describes how to identify a problem. 
This part contains the following information: 


— Chapter 1, “Diagnosing VTAM Problems: Where to Begin” on page 3 
describes the basic problem identification process. 


— Chapter 2, “Collecting Documentation for Specific Types of Problems” on 
page 57 describes general procedures to collect documentation. 


— Chapter 3, “Collecting Documentation for TSO/VTAM Problems (MVS)” on 
page 113 describes procedures to collect documentation for TSO/VTAM 
problems. 


— Chapter 4, “Collecting Documentation for VSCS Problems (VM)” on | 
page 131 describes procedures to collect documentation for VSCS prob- 
lems. 


e “Part 2. Diagnostic Procedures” on page 189 describes how to use diagnostic 
procedures. This part contains the following information: 


— Chapter 5, “Using DISPLAY and MODIFY Operator Commands” on 
page 193 describes how to use VTAM commands to collect dump and 
trace information. 


— Chapter 6, “Using Dumps” on page 213 describes dump procedures. 
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Chapter 7, “Using VTAM Dump Analysis Tools (MVS)” on page 237 
describes how to analyze dump information. 


Chapter 8, “Using Traces” on page 347 describes how to use traces to 
collect information. 


Chapter 9, “Using the VTAM Internal Trace (VIT)” on page 397 describes 
how to use the VTAM Internal Trace (VIT). 


Chapter 10, “Using the VIT Analysis Tool (MVS, VM)” on page 411 
describes how to use the VIT analysis tool. 


Chapter 11, “Using VSCS Service Aids (VM)” on page 449 describes mes- 
sages, commands, dumps, traces, LBCSTATE values, and WEB function 
codes for VSCS. 


Chapter 12, “Using Other Problem Solving Tools” on page 539 describes 
alerts, 3745 bus switching messages, the IBMTEST command, error 
recording, patch areas, and save area module linkage. 


e “Part 3. Diagnostic References” on page 559 contains diagnostic reference 
material. This part contains the following information: 


Appendix A, “VTAM Internal Trace (VIT) Record Descriptions” on page 567 
describes the VIT records. | 


Appendix B, “Finding VTAM Buffer Pools (VM, VSE)” on page 837 pro- 
vides step-by-step instructions for finding buffer pools. 


Appendix C, “First Failure Support Technology (FFST) Probes (MVS)(VM)” 
on page 845 describes the FFST™ probes that trigger dumps when an 
unusual condition occurs in VTAM. 


Appendix D, “Channel Programs” on page 873 illustrates channel pro- 
grams to help resolve network |/O-related problems. 


Appendix E, “Network Flows” on page 925 illustrates flows of VTAM 
request or response units (RUs) in order to help resolve VTAM problems. 


Appendix F, “APPN Flows” on page 1013 describes flows between APPN 
end nodes, network nodes, interchange nodes, and the subarea network. 


Appendix G, “Control Point/Control Block (CPCB) Operation Codes” on 
page 1127 describes control point/control block (Cree) operation codes 
that identify VTAM processes. 


Appendix H, “Storage and Control Block ID Codes” on page 1137 summa- 
rizes storage and control block ID codes that identify VTAM control blocks. 


Appendix |, “Path Information Unit (PIU) Discard Reason Codes” on 
page 1141 describes PIU discard reason codes in order to help isolate 
VTAM session and network problems. 


Terms Used in the VTAM Library 
Clarification of some terms used in the VTAM library follows: 


e The term Advanced Peer-to-Peer Networking’ (APPN") represents VTAM's 
implementation of APPN. 


e The terms CPCP and CP-CP are similar but have different meanings. CPCP is 
the name of a start option or operand. CP-CP refers to CP- CP sessions 
between control points. 
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e The term end node represents an APPN end node. 


e The term integrated communication adapter (ICA) is used to represent all of the 
following, except where it is necessary to use the specific term: 


— Communication adapter 

— Telecommunications Subsystem Controller 

— IBM Token-Ring Subsystem Controller 

Workstation Subsystem Controller 

Multi-Protocol Communication Subsystem Controller. 


e The term network node represents an APPN network node. 


e The term VTAM refers to the VTAM program for V4R2 unless otherwise stated. 


Symbols Used in the VTAM Library 


The following symbols are used in the VTAM library to indicate information that — 
applies only to a particular operating system or processor: 


MVS Indicates information that applies only to MVS/ESA". 
VSE Indicates information that applies only to VSE/ESA". 
Indicates information that applies only to VM/ESA‘. 


These symbols either precede or follow unique information in the VTAM library. 
Following is an example of how these symbols are used: 


VSCS is a VTAM application program and must be defined to VTAM. 


What Is New in This Book 


Information has been added to this book to reflect the new functions in VTAM V4R2 
for VM/ESA and VSE/ESA. Changes have also been made as a result of user 
comments. 


This book was last published in May 1994 with order number LY43-0065-00. 


This book was last published in March 1992 with order number 
LY43-0059-1. | 


The glossary has been deleted from this publication. For definitions of the terms 
and abbreviations used in this book, refer to the V7AM Glossary. 


The following sections contain summaries of the changes that have been made for 
each new function. Further information about the functions can be found on the 
pages referred to in these summaries. “Usability Enhancements to This Book” on 
page xliili describes usability changes that have been made to this book. 
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Network Dynamics 


Advanced Peer-to-Peer Networking (APPN) Support 
“Common Problems in APPN Networks” on page 27 has been added to help you 
solve some common APPN problems before calling the IBM Support Center. 


Appendix F, “APPN Flows” on page 1013 has been added. 
Operator Interface Enhancements 


Display of Active Traces 
A new command, DISPLAY TRACES, has been added. See “Display Traces” on 
page 208. 


Performance Enhancements 


Multipath Channels between Host Processors 
Information on this new connectvity has been added to Appendix D, “Channel 
Programs” on page 873. 


Non-Disruptive Deactivation of Cross-Domain Resource 
Managers 

For flow diagrams illustrating this function, see Figure 168 on page 994, 
Figure 169 on page 995, and Figure 170 on page 996. 


Problem Diagnosis 


“Common Problems in Subarea Networks” on page 6 has been added to help you 
solve some common subarea problems before calling the IBM Support Center. 


Buffer Contents Trace Enhancements 

The full buffer contents trace can now record all data contained in each buffer, 
making it easier to diagnose problems in the network. See “Buffer Contents Trace” 
on page 369. 


Capturing of Diagnosis Information with First Failure Support 
Technology (FFST) (VM) 

First Failure Support Technology (FFST) helps you resolve VTAM software prob- 
lems by capturing information about a potential problem when it occurs. See “First 
Failure Support Technology (FFST) for VTAM (MVS) (VM)” on page 217 and 
Appendix C, “First Failure Support Technology (FFST) Probes (MVS)(VM)” on 
page 845. 


VTAM Internal Trace (VIT) Enhancements 
Appendix A, “VTAM Internal Trace (VIT) Record Descriptions” on page 567 
includes new and updated VIT entries. 


The following default VIT options are automatically active and cannot be turned off: 


e API 
e MSG 
e NRM 
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e PIU 
e SSCP. 


For more information see “Activating the Internal Trace” on page 398. 


You can simultaneously record VIT data internally and externally. See 
“Internal and External Trace Recording” on page 401. 


See “Recording Traces in External File (MODE=EXT)” on page 403 for infor- 
mation on determining the size of the trace table. 


VTAM Internal Trace (VIT) Analysis Tool (VM) 
You can now process externally recorded VIT records with the VIT analysis tool, 
which enables you to: 


e Analyze storage 
e Count RUs 
e Extract information from VIT records. 


See Chapter 10, “Using the VIT Analysis Tool (MVS, VM)” on page 411. 


System and Configuration Management 


Dependent LU Server 
“Dependent LU Server Flows” on page 1098 has been added. 


Virtual-Route-Based Transmission Groups 
A flow diagram has been added, illustrating activation of a CDRM with a virtual- 
route-based transmission group. See Figure 117 on page 945. 


VM/SNA Console Support (VSCS) Enhancements 


See Chapter 11, “Using VSCS Service Aids (VM)” on page 449 for enhancements 
to VSCS, including network qualified name (NQN) support, the operator trace 
(OPER), and the storage statistics trace (STAT). 


Usability Enhancements to This Book 
e To make information easier to find, the book has been divided into three parts, 
and some chapters have been reorganized. 


¢ A sample path problem has been added. See “Example: Solving Path 
Problems” on page 199 for additional information. 


e Indexes have been added for the flow diagrams, and the subarea flows have 
been reorganized so that flows are easier to find. See Table 64 on page 926 
and Table 71 on page 1014. 


e Command syntax is depicted in “railroad track” syntax diagrams instead of the 
brackets-and-braces style used in previous editions of this manual. The rail- 
road track style is being adopted by all IBM products. If you are not familiar 
with railroad tracks, refer to “How to Read the Syntax Diagrams” on page 238. 


If you wish to comment on the use of railroad tracks or other documentation 
concerns, a Reader's Comment Form is located at the back of this manual. 
Your feedback will be appreciated. | 
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Where to Find Information about VTAM 


“Bibliography” on page 1159 describes the books in the VTAM V4Rz2 library, 
arranged according to related tasks. In addition, Table 80 on page 1165 tells 
where to go for information on a variety of related topics. 
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Chapter 1. Diagnosing VTAM Problems: Where to Begin 


This chapter includes the following sections: 


e To help you determine the source of your problem, see “Determining Whether 
the Problem Is VTAM or Non-VTAM” on page 4. 


¢ To compare your problem to a list of common problems that have been identi- 
fied by the IBM Support Center, see “Common Problems in Subarea Networks” 
on page 6 and “Common Problems in APPN Networks” on page 27. 


For additional information, see “Common Symptoms and Associated VTAM 
Problem Types” on page 39. 


e If you are having problems with the trace or dump analysis tools, see “VTAM 
Internal Trace (VIT) Analysis Tool Problems (MVS) (VM)” on page 42 and 
“VTAM Dump Analysis Tool Problems (MVS)” on page 46. 


e To gather additional documentation to help you to solve your problem, see 
“Recommended Documentation for VTAM Problems” on page 48. 


e To prepare your documentation for submission to the IBM Support Center, see 
“Submitting Problem Documentation” on page 53. 
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Determining Whether the Problem Is VTAM or Non-VTAM 


Problems can be classified into two types: 


VTAM problems 
These are problems that occur in the VTAM program. 


Non-VTAM problems 
These are problems that occur because of changes to your network or prob- 
lems caused by other application programs or software in the network, such 
as a network control program (NCP) or a local area network (LAN). 


If you did any of the following, the problem might be in your network setup, in 
your configuration, or in another IBM product. 


Did you modify an application program that has run without problems in 
the past? 


Did you modify a product exit routine that has run without problems in the 
past? 


Did you change the processing environment? For example, did you intro- 
duce a new host processor or communication controller? 


Did you modify the operating system, or did you install a new release of 
the operating system? 


Did you add a new terminal to your VTAM network that had incorrect fea- 
tures or incorrect Request for Engineering Activity (REA) and Engineering 
Change (EC) levels? 


Did you attach a link? 
Did you set switches at a terminal? 
Did you initialize link parameters for a programmable controller? 


Did you modify installation-provided VTAM tables? For example, did you 
modify logmode, class-of-service (COS), or unformatted system services 
(USS) tables? 


Did you modify VTAM messages? 


If you cannot resolve the problem on your own: 


e Compare your problem to the examples in “Common Problems in Subarea 
Networks” on page 6 and “Common Problems in APPN Networks” on page 27. 


e Check Table 4 on page 39 for your problem symptom. 


e Follow the instructions in “Recommended Documentation for VTAM Problems” 
on page 48. To gather additional information, refer to Chapter 2, “Collecting 
Documentation for Specific Types of Problems” on page 57. 


e For non-VTAM problems, call your IBM branch office. For suspected VTAM 
problems, do either of the following steps: 


— lf you have access to IBMLink’, search for known problems in this area. If 


no applicable matches are found, report the problem to IBM by using the 
electronic technical report (ETR) option on IBMLink. 


— Contact the IBM Support Center at 1-800-237-5511. 


4 VTAM V4R2 Diagnosis 
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If a reported problem is a hardware, network definition, or user definition error, the 
IBM Support Center representative creates an ASKQ item for VTAM. The ASKQ 
item includes the solution for the problem and can be found in the problem determi- 
nation database (PDDB). 
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Common Problems and Symptoms 
This section contains the following information: 


e “Common Problems in Subarea Networks” 
e “Common Problems in APPN Networks” on page 27 
e “Common Symptoms and Associated VTAM Problem Types” on page 39. 


Even in cases when a VTAM problem has the same symptoms as a non-VTAM 
problem, by studying similar examples in this section, you may be better prepared 
when you contact the IBM Support Center. 


If you have access to a software support database, you can search for your 
problem in that database and apply any recommended correction. 


Common Problems in Subarea Networks 


Table 1 includes a brief description of several common problems that occur in 
subarea networks. For additional information, go to the page indicated. 


Table 1 (Page 1 of 2). Index of Common Problems in Subarea Networks 


Problem See 
Abend 0C4 in ISTTSCPF when move character instruction processed (reason code 4, 10, or 11) Page 7 
Activating an NCP and resources fail Page 25 
APPL-APPL storage expansion failure with messages IST154!, IST5611, IST999E, IST566I1, and Page 19 
IST930I 

BIND failure with message IST6631 (sense code 083500xx or 08210000) and USSMSG07 Page 23 
CICS* logon problem with message IST6631 (sense code 08210000) Page 17 
CINIT failure with message IST6631 (sense code 08010000) Page 20 
DSRLST pending condition and CD DSEARCH PENDING in message IST530!1 or message IST1278I Page 17 
LU hung in PNFYx state | Page 8 
Message IKT029I with return code 061001 (TSO logon failure from a session manager application Page 9 
program) 

Message IST259I and sessions end unexpectedly for a terminal, PU, line, or NCP Page 10 
Message IST259l indicating that an INOP RU was received for a link problem | Page 9 
Message IST264I (required COS entry undefined) and message IST663! with sense code 08610000 Page 17 
Message |IST467I with error type 05, 07, 08, or OB during activation of a PU Page 11 
Message IST489! when activating a major node Page 14 
Message IST530I (DSRLST pending condition) Page 17 
Message IST530!I (GUNBIND pending) Page 15 
Message IST530!1 (NMVT PENDING) | Page 16 
Message IST663I with sense code 08010000 (CINIT failure) | Page 20 
Message IST663I with sense code 08210000 (CICS logon problem) Page 17 
Message IST663l (sense code 083500xx or 08210000) and USSMSGO07 (BIND failure) Page 23 
Message IST663I (sense code 08610000) and message IST2641 (required COS entry undefined) Page 17 
Message IST1272I when activating a major node Page 14 
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Table 1 (Page 2 of 2). Index of Common Problems in Subarea Networks 


Problem See 
Message IST12781 (DSRLST pending condition) Page 17 
Message IST1278! (GUNBIND pending) Page 15 
Message IST1278! (NMVT PENDING) Page 16 
Messages IST154l, IST5611, IST999E, IST566!, and IST9301 (APPL-APPL storage expansion failure) Page 19 
Messages !ST718I and IST7191 when activating a CDRM Page 14 
PNFYx resource state and LU hung Page 8 
PSESEND session termination state and hung session Page 15 
Resources fail when activating an NCP (sense codes 10030000 and 08090000) Page 25 
Sense code 08010000 with message IST663I (CINIT failure) Page 20 
Sense code 081C0008 Received on ACTLINK Page 21 
Sense code 081C000C Received on ACTLINK Page 21 
Sense code 08210000 with message IST6631 (CICS logon problem) Page 17 
Sense code 083500xx or 08210000 (message IST663I) and USSMSG07 (BIND failure) Page 23 
Sense code 08610000 (message IST663!) and message IST264l (required COS entry undefined) Page 17 
Sense code 0888000x with session failure Page 25 
Sense code 800A0000 or no message with session failure Page 24 
Sense code 80130104 and path problems Page 199 
Sense codes 10030000 and 08090000 (resources fail wnen activating an NCP) Page 25 
Session fails with sense code 0888000x Page 25 
Session hung with PSESEND session termination state Page 15 
Sessions end unexpectedly for a terminal, PU, line, or NCP with message IST259] Page 10 
Sessions end with no message or sense code 800A0000 Page 24 
Storage problem Page 105 
TSO application program receives partial input for the TGET macroinstruction Page 20 
TSO logon failure from a session manager application program with message IKTO29I and return Page 9 
code 061001 

USS message USSMSG07 and message IST663! with sense code 083500xx or 08210000 (BIND Page 23 
failure) 

VTAM trace records were expected but are not in the GTF trace data set Page 19 


Descriptions of Common Problems in Subarea Networks 


This section includes examples of common problems in subarea networks. See 
Table 1 on page 6 for an index of these problems. 


Abend 0C4 Occurs in ISTTSCPF 


Problem Statement 
An abend 0C4 with a reason code of 4, 10, or 11 occurs in all levels of the module ISTTSCPF 
when a move character instruction is processed. 
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Common Symptoms | | 
The USS message contains unexpected or extraneous characters, but not all USS messages are 
affected. Devices might not activate correctly or might fail to logon correctly. An abend O0Cx 
might occur in module ISTTSCPF. 


Probable Cause 
The USSTAB is incorrectly defined. In this module, register 4 points to storage that may not be 
paged-in (reason code 10 or 11) or to storage that should not be accessed (reason code 4). 


The TSCB contains a data length field (TSCDATLN) equal to the length of the USSMSG text 

plus the length field itself. Subtracting the value in register 4 from the starting address of the 
USSMSG table shows that only the value of TSCDATLN (minus 2 bytes) was moved because 
the full amount of storage that was referenced was not pagec-in. 


User Response 
Code only the length of the USSMSG entry in the USSMSG table. Do not include the size of the 
length field. 


Line hangs in PALNK status 


Problem Statement 
A line is hung in PALNK status when ISTATUS=INACTIVE is coded on a line definition 
command. 


Common Symptoms 
Messages IST530! (or IST1278I, if MSGLVL=V4R1) ACTLINK PENDING and IST5311 are 
received from a VTAM to ICA LINK request. 


Probable Cause 
On the LINE definition statement, the continuation character was put in column 71 instead of 
column 72. 


User Response 
At assembly time, determine how comments are to be identified for each type of definition state- 
ment. 


LU Hung in PNFYx State 


Problem Statement 
An LU can hang in a PNFYx state if the application program does not issue the CLSDST macro- 
instruction when a LOSTERM user exit routine is scheduled. 


Common Symptoms 
An LU is hung in a PNFYx state. The LU is unable to log on to an application. 


Probable Cause 
An application program failed to issue the CLSDST macroinstruction when the application's 
LOSTERM user exit routine was scheduled with a reason code indicating that the CLSDST 
macroinstruction should be issued. 


User Response | 
Check with the owner of the application program for known problems. A VTAM internal trace 
with the application interface (API) option active indicates whether the LOSTERM user exit was 
scheduled and the reason code that was passed. The API trace option can also be used to 
determine if the CLSDST was issued by the application in response to a LOSTERM user exit. 
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Notes: 
1. See Page 85 for information on the VARY INACT,FORCE command and PNFYx status. 


2. The information in this problem description is from information APAR 1100757. See that 
APAR for additional information. 


Message IKT029I (Return Code 061001) Received with TSO Logon Failure (MVS) 


Problem Statement 
Cannot log on to TSO from a session manager application. 


Common Symptoms 
The following message is displayed: 


IKTO29I RC= 061001 SENSE= code TERMINAL termid ABOUT TO BE RELEASED BY VTAM 


Probable Cause 
Either the application or D/T8100 expects the first BIND from TSO to be from terminal control 


address space (TCAS). TCAS will only send the BIND for the TSO sub-application program 
(TSOxxxx). 

User Response 
If the secondary logical unit (SLU) does not support this type of session initiation, specify 
FASTPASS=NO on the SLU definition statement to force TCAS to send a BIND to the SLU 
before the TSO sub-application program sends its own BIND. 


Message IST259l Received with INOP RU 


Problem Statement 
Message IST2591 is generated by the inoperative (INOP) RU processor. The INOP RU is gener- 
ated by the data link control (DLC) component for the subarea controlling the link, either interme- 
diate network node (INN) or route extension (REX). 


Common Symptoms 
The following message is displayed: 
IST259I INOP RECEIVED FOR nodename CODE = code 
If the link is INN, an ER.INOP will also flow, producing a series of explicit route (ER) or virtual 


route (VR) failure messages. This leads to an incorrect diagnosis when you do not associate the 
ER.INOP with the link or link station INOP. 


If message IST259I contains the name of a channel-attached NCP or a local device, 
message |OSOOOI or IST446I might accompany the failure. 

Some local SNA controllers require I/O buffer size to be an even number. For example, if an 
odd number is coded for a 3174, message IST2591 with CODE=01 will be displayed at acti- 
vation. 


Message IST2591 with CODE=01 might be returned for a 9370 using a 6120 or 6120 
control unit emulator if the I/O buffer size is less than 256. 


Probable Cause 


NCP link 
This is a communication facility problem. Either the retry limit is exhausted, a negative 
acknowledgement is received for an SDLC transmission, a modem error occurred, or a link 


failure occurred. 
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Channel link | 
Either a data transfer count mismatch occurred, an NCP abend has occurred, or the NCP 
was reloaded by another host. 


ICA link 
This is the same as the NCP link problem, but no RECMS was received. 


User Response 
Trace the link. 


List the system LOGREC or SYSREC to obtain the data from the record man- 
agement statistics (RECMS) that accompany an INOP originating in an NCP node. The RECMS 
identifies the error that produced the INOP. Use environmental record editing and printing 
(EREP) to print the LOGREC records. Use the network problem determination application 
(NPDA) to interpret the RECMS record. 


VTAM does not generate the RECMS for channel link and link station failures. The 
LOGREC or SYSREC entry for a local device will contain only statistical data. 


Correct the error condition. 


Note: The IBM Support Center representative can only suggest that you list LOGREC or 
SYSREC and assist you with interpreting the record. 


If a channel-attached SNA device (NCP or cluster controller) is experiencing the INOPs at a 
regular or predictable interval (for example, every hour), the problem could be that VTAM'S ERP 
routine has been deleted. Verify that CSECT ISTZBMOK in loadmodule IGE0004 
(LPALIB) has not been deleted. 


Message IST259l Received and Sessions End Unexpectedly 


Problem Statement 
One or more sessions have ended unexpectedly, and a terminal, PU, line, or NCP is in a wait 
state. 


Common Symptoms 
The following message is displayed: 


IST259I INOP RECEIVED FOR nodename CODE = code [text] 
Probable Cause 
e |f the node is an NCP, the NCP detected an error and generated the INOP RU message. 


e If the node is a channel-to-channel (CTC) link or a CTC link station, VTAM detected an error 
from an IO operation and generated the INOP RU message. 


e If the node is a local attachment device, VTAM detected an IO error and generated the INOP 
RU message. 


User Response 


e For an explanation of the code in IST259l, refer to the description of the message in VTAM 
Messages and Codes. 


e Check the system log for system (IOS) error messages that contain status information. 
e If the NetView’ program is installed, check NPDA for logged errors. 
e Run EREP against LOGREC, and check for errors related to the device. 


Note: This information should identify the component causing the error. Contact the appro- 
priate service organization for help with a specific component problem. 
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Message IST467I Received with CONTACTED ERROR TYPE 05, 07, 08, or OB 


Problem Statement 
Message IST467I is received with contacted error type 05, 07, 08, or OB during activation of a 
resource. The message indicates that the XID was rejected by the PU. 


Common Symptoms 
IST467I is the first in a group of messages. The exchange IDs (XIDs) are included in IST468l, 
IST4691, IST4701, and IST471I in the message group. Compare the XIDs to determine why the 
PU rejected the XID. 


Sample XIDs from an IST467I message group: 


KREKEKKEKKEKKKEEKEKEKRERKKKRKKKKKKKKKREKRKKKKKEK 
x The following is for XID format 2. All * 
* references to bytes and bits are in hex. * 
KEKEKKKRKEKRKEKKEEKREKKREKKEREREKKERKEKRRKEKRRKREKREEK 
XID1 (Received from the NCP) = 
Z42AFFFO 00000000 00080000 00010000 
00035007 D5C3D7D3 D6C1C440 80000203 
00Z2A05F3 00800000 0000 
XID2 (Sent to the NCP by VTAM) = 
Z42AFFFO 00000000 200800F9 DE010000 
00010000 40404040 40404040 81000200 
002A05F3 00000000 0000 


Note: If type is OB in message IST467I, additional error information may be contained in a CV 
X'22' appended to the end of the XID. See the User Response for examples. 


Probable Cause 


Note: The explanations that follow cover more than the single error that the sample XID1 and 
X!ID2 represents. | 


The first digit of the XID is the format. In the sample XIDs above, the format is format 2. 
Byte X'12' of the XID1 received from the NCP is the error byte. 


Bit 0 Reserved (unused) 

Bit 1 Received XID is unacceptable. 

Bit 2 Incompatible 

Bit 3 Transmission group (TG) undefined 


Bit 1 of byte X'12' is set for the following reasons: 


1. The XID2 at displacement X'00' was not equal to 24 or 25. 
2. The XID2 at displacement X'08' was not equal to 20. 

3. The XID2 at displacement X'13' was not equal to 00. 

4. The XID2 at displacement X'1E' was not equal to 02. 

5. Depending on the release of NCP you have: 

a. For NCP V4R3, V5R2, and later: The XiD2 from VTAM at displacement X'0B'—X'0C' 
is less than 1296 decimal (X'0510'). The value in this field is the result of MAXBFRU 
times UNITSZ specified on the HOST definition statement in the NCP. The value of 
UNITSZ should be the same as the value of the IOBUF buffer size in the VTAM start list. 
This error is set only when the NCP definitions have specified the HOST connection 
using GROUP LNCTL=CA. 

b. For NCP prior to V4R3 and V5R2: The X|D2 from VTAM at displacement 
X'0B'—X'0OC' is less than (XID plus X'20'—X'21') times (XID plus X'22'—X'23') 
minus (XID plus X'24') in the XID sent by NCP. This result corresponds to the value 
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specified on the MAXBFRU operand times the value specified on the UNITSZ operand 
minus the value specified on the BFRPAD operand. | 
6. There is no path to the subarea number defined at X'11' in the XID2 that uses this con- 
nection. 
7. Bit 2 of byte X'12' is set because the received XID1 at X'25' is not equal to X'20', and an 
existing connection exists with the origin subarea. 
8. Bit 3 of byte X'12' is set because either the TG number in the XID2 at displacement X'0D' 
or the subarea from the XiD2 at X'11' is unknown to the NCP. 


User Response 
Reasons 1, 2, 3, and 4, should not occur, but should help to verify XID offsets. 


For reason 5, refer to the VTAM Resource Definition Reference and the NCP, SSP, and EP 
Resource Definition Reference regarding specification of buffer sizes. 


For reason 6, refer to the VTAM Resource Definition Reference and the NCP, SSP, and EP 
Resource Definition Reference regarding the definition of PATH statements. Also, transmission 
group (TG) mismatch could cause the problem. A TG mismatch could occur, for example, if an 
NCP is attached as a CA major node, and TG=ANY is coded in the CA major node in VTAM, 
and TG=ANY is coded on the NCP line definition for this attachment. 


For reason 7, refer to the VTAM Resource Definition Reference regarding the use of the 
CHANCON parameter of the PCCU macro. 


For reason 8, refer to the NCP, SSP, and EP Resource Definition Reference regarding the use 
of the CANETID parameter on the BUILD macro. Verify that it is coded correctly for each 
network in which it is assigned. 


Notes: 


1. In the sample XID1 given above, byte X'12' contains the value X'50'. Bit 2 and bit 3 
indicate that the XID2 was unacceptable and that the transmission group was not defined. 
The problem in this case was that there were no PATH definition statements defined in the | 
NCP for the host subarea. 


2. The contacted error type 05 can also be posted if the NETIDs in the 2 XIDs do not match. 


The NETID will appear ina CV X'12' at the end of the XIDs. If they do not match, correct 
the NETID operand on the PU definition statement in one or both PU definitions. 


3. A contacted error type 05 may occur if a channel-to-channel connection is defined between 
two VTAMs that have the same subarea. Subarea numbers must be unique. 


In this case, the 4 bytes starting at offset X'E' in XID1 and XID2 will be the same. XID 
offset X'E' contains the subarea numbers. XID1 contains the subarea number of the 
receiver, and XID2 contains the subarea number of the sender. 


The following examples are for type OB when a CV X'22' is appended to the end of the XID. 
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KEEKKKEKERKEKKKRKEE 


* Example 1: * 
KRREKKKKKEKEKKKKREKE 


TST4671 CONTACTED ERROR TYPE OB FOR ID = NCPPUX 

IST4681 §X1ID1=348AFFFFFFFD000010F74100000000801502 135000327 E03000000FO 
IST4691 000107080000000000460909801500000000004FOEOAF4C8D6C4C34BC3FOF1 
IST4691 F1QEO8F1ID5FOF7FOFOFOF8Q0E09F7D7E4D3F2F2F4F0F1103700161101130011 
IST4691 F3F7F4F5F3F1C1F5F7FOFOF1FOF8F6F42011040E02F5F6F8F8F2F3F1IFOFOF2 
IST4691 FOFZQ0804FOF6FOFZFOFO07099302880815 


IST470I XID2=3596FFFO00000000010B74100000000800002 13000030000300200180 
IST471I 0001070800000000000E0AF 1C8D6C4C34BC3FOF1FOOEOAF4C8D6C4C34BC3F0 
IST4711 F1FOOEO7F7D5C3D7D7E4E74609098000000000000000103A002311040E02F5 
IST4711 FOFOFSFIFIF7FOFIF1FOF10804FOF4FOF1FOFQOAQ6C1C3C661E5E3C1041611 
IST4711 01130011F9FOFZF1O0000000000FOF1F2FOF6F1F2220700186000000000 


CV X'22' showing error 
in byte X'18' 


KEKEKEREKKERKKKRKKEK 


* Example 2: * 
KREKKKKKKKKKRRRKEK 


IST4671 CONTACTED ERROR TYPE OB 


XID1=32 4A 05 6A 40 32 00 00 80 06 CO 00 00 00 00 00 O01 O01 OB 70 00 OF 
DC 00 00 00 00 07 00 OE OD F4 E2 C5 E2 D7 C1 C4 FO FO 4B E4 E3 E5 
10 17 Fl 16 11 01 13 00 11 FO F4 FO F6 C6 F4 F5 F4 F4 FO FO Cl F4 
FO F3 F2 22 03 00 OF 00 


CV X'22' showing error 
in byte X'OF' 


XID2=34 85 FF FF FF FC’ 00 00 10 C7 41 00 00 00 00 80 00 01 OB 70 0010 
BA 00 00 00 00 07 00 46 09 09 80 00 00 00 OO O00 00 IF OE 12 F4 E2 
C5 £2 D7 Cl C4 FO FO 4B E2 C5 E2 D7 Cl C4 FO F4 OE O5 Fl D5 F3 Fl 
D7 OE 07 F7 C3 F3 Fl E4 E3 E5 10 37 00 16 11 O1 13 00 11 F3 F7 F4 
F5 F4 Fl FO F5 F7 FO FO F1 FO FO FO Fl 20 11 04 OE O2 F5 F6 F8 F8 
F2 F3 Fl FO FO F2 FO F2 08 04 FO F6 FO F2 FO FO 07 09 93 02 67 12 
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RERKEKRKEKEKRKERERRRER 


* Example 3: * 
KEKEKKKKEKRKREKEKKKEKE 


IST590I CONNECTIN ESTABLISHED FOR PU IBT10P1 ON LINE JOOOA027 

IST467I CONTACTED ERROR TYPE OB FOR ID = IBMOOOQP1 

IST468I XID1=326C05D9000100008074C1000000008000010B707890001000004 
IST469I OOOEOFF4D5C5E3F2E2C9E34BE6C1D5C7C3D70E09F7D3C9D5D2FOFOFOF 11028 
IST469I 001111040E02F5F6F2F1F2F5F4FOFOF2FOF0161103130011F5F1F7FOFOFOFO 
IST4691 FOFOFOFOFQFOFOFOF0220700090108090054 


CV X'22' with error byte X'09', 

bit 1 offset, and sense 08090054 included. 
The new length and sense occurs only in 
APPN nodes (VTAM Version 4 Release 1 and 
NCP Version 7 Release 1 or higher). 


IST470I XID2=347 1FFFFFFFC0000108640000000000000010B7000105A0000000007 
IST4711 QOQEOFF4D5C5E3F2E2C9E34BC9C2ZE3C7 E6F30E08F 1C9CZ2E3F1FOC7E6103700 
IST4711 161101130011F3F7F4F5F6F1FOFOFOFOFOFOFOF7F8F92011040E02F5F6F8F8 
IST4711 F2F3F1FOFQF1FOF20804FOF7FOF1FOFO07099303191115 


See the description of message IST4671 in VTAM Messages and Codes for additional informa- 
tion. 


Message IST489l or IST1272I Received When Activating a Major Node 


Problem Statement 
Message IST4891 or message IST1272I is received when VTAM is activating a major node. 


Common Symptoms 
Message IST489I or message IST1272l is received. 


Probable Cause 
These messages indicate a duplicate name, parameter, or network address. 


¢ The name might be the name of the node or subnode. 
e The parameter might be the IDBLK and the IDNUM values specified for another subnode. 
e The CPNAME specified for a subnode might be duplicated in the network. 


User Response 
The duplicate name can be discovered by entering the VTAM DISPLAY ID parameter for the 
name specified in message IST4891 or message IST1272l. 


If the node receiving message IST489I or message IST1272I contains IDBLK and IDNUM or 
CPNAME, check other definition statements that also contain IDBLK, IDNUM, or CPNAME for a 
duplicate definition name. 


A duplicate network address may be more difficult to find because most network addresses are 
not explicitly defined. However, because the VTAM internal trace is run with OPT=(NRM,MSG), 
you can find the duplicate using the following process: 


1. When the trace is run and message IST4891 or message IST1272I has been issued, use the 
console DUMP command to dump VTAM's region and CSA or VTAM's virtual 
machine and CSA or VTAM's partition and SVA . 


2. Locate the MSG entry for message IST489I or message IST1272l in the trace. 
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3. Before the message entry, locate the SRTA entry, which should have a non-zero return 
code, usually 04. The SRTE pointer field of this SRTA entry will point either directly or indi- 
rectly to the duplicate name. 


The SRT entry address field contains a storage address that can be located in the VTAM 
dump. This address points to the node name containing the duplicate definition name, or the 
SRT entry points to the node containing the duplicate name or address. This pointer is at 
offset X'10' into the SRT entry. For more information see “SRTx Entry for SRTADD, 
SRTCHG, SRTDEL, SRTFIND Macros” on page 794. 


Message IST530! or IST12781 Received with GUNBIND PENDING or Session Hangs 
in PSESEND State 


Problem Statement 
A GUNBIND PENDING message is received at logoff time in a cross-domain environment (if 
lOPD is specified or defaulted in the VTAM start options), or the session hangs in PSESEND 
session termination state. 


Common Symptoms 
e Message IST530I or IST1278I: 
GUNBIND PENDING FROM applname TO LU 
e Message IST530! or IST1278I 
GUNBIND PENDING FROM VTAM TO LU 
e The session displays PSESEND as the session termination state. 
Probable Cause 
e The application did not issue a CLSDST macroinstruction. 


e The device did not respond to the UNBIND request or returned a response that was incor- 
rect or not valid. 


e A virtual route between the primary logical unit (PLU) subarea and the secondary logical unit 
(SLU) subarea is held or blocked. 


e The network ID defined in the NCP does not match the network ID coded in the VTAM start 
options. 
User Response 
e Enter (on the terminal owning the host) and note the status: 
D NET, ID=devicename,E 
e If the session termination state is PSESEND, enter: 


D NET,SESSIONS,SID=sid (where the SID is that of the PSESEND 
session in the IST635I message group) 


This display will show which session partner is Cena the session end signal to com- 
plete the session termination. 


— lf a SESSEND is needed from the PLU, VTAM is waiting for a CLSDST macroinstruction 
to be issued. 


— If a SESSEND is needed from the SLU, there is usually a problem in a network element 
such as the host VTAM, NCP, or SLU. 


e If the device is remote and hangs in PSESEND session termination state at logoff, start the 
following trace (in the device-owning host), and trace a logon and logoff: 
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F NET, TRACE, TYPE=BUF, ID=devicename 

The X'15' vector in the SESSST and SESSEND RuUs (if they are present) should be 

checked to see if the network ID matches the network ID coded in the VTAM start options. 
e Enter (on the application-owning host) and note the status: | 

D NET, ID=app]name,E 

This indicates whether other sessions are affected. If the application name has many ses- 

sions, this display output can be very large. 

D NET, ID=devicename,E 


This indicates whether the session status matches the session status in the device host. 
D NET,ROUTE,DESTSUB=device subarea_number, TEST=YES 

This indicates that a virtual route is held or blocked. 

D NET, TERM,SID=sid, TYPE=FORCE 

This may help expedite session termination. 


e If it is suspected that no CLSDST macroinstruction is being issued, a buffer trace of the 
application and a VTAM internal trace with MODE=EXT,OPT=API specified may be needed 
to verify: | 


— That the application was notified of session termination 
— Which exit was scheduled 
— What action/commands were issued (if any) by the application. 


Message IST530I or IST1278I Received with NMVT PENDING 


Problem Statement | 
Message IST530I or IST1278i is issued for a PU even though the NetView program (if installed) 
or the RISC System/6000° network management program for RISC System/6000 devices 
receives session awareness (SAW) data for a SNA device. 


Common Symptoms 
Message IST530I or IST1278l is issued each time the IOPD timer expires. For additional infor- 
mation, see the message description in VTAM Messages and Codes. 


Probable Cause 
The device is not real-time-monitor-capable. This means that the device did not process the 
response and return the requested information properly to the NetView program for most 
devices, or to Network Management/6000 for RISC System/6000 devices. A microcode change 
is needed to permanently resolve this problem. | 


User Response 
You can prevent this problem by pointing the device to a KCLASS and using a SAW data filter to 
stop VTAM from attempting to collect the data. 


Note: See “Reducing Session Awareness (SAW) Data” in the VTAM Network Implementation 
Guide and “Session Awareness (SAW) Data Filter (MVS)” in the VTAM Resource Definition Ref- 
erence for details on how to code a SAW data filter. 
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Message IST530I or IST12781 Received with Pending DSRLST Condition 


Problem Statement 
A DSRLST PENDING message is received. Message IST530I or IST1278I is issued with CD 
DSEARCH PENDING FROM netid TO netid. 


Common Symptoms 
Message IST530I or IST1278I is issued for the application. 


Probable Cause 


e The ADJSSCP table was not coded; the ADJSSCP table is coded incorrectly; or the IOINT 
value is too low. 


e The start option DYNASSCP and the ADJSSCP table are not correctly tuned. 
User Response | 
To identify the ADJSSCP, enter (with or without a NETID operand): 
D NET,ADJSSCPS 
To determine the current value of IOINT, enter: 
D NET, VTAMOPTS ,OPTIONS=IOINT 
To identify the ADJSSCP, enter (with or without a NETID operand): 
D NET,ADJSSCPS 
To determine the DYNASSCP value, enter (and note the DYNASSCP value specified): 


D NET, VTAMOPTS, OPTIONS=* 
or 
~D NET, VTAMOPTS , OPTIONS=DYNASSCP 


Message IST663! (Sense Code 08210000) and cannot logon to CICS 


Problem Statement 
Sessions cannot logon to CICS. 


Common Symptoms 
The message IST6631 CINIT REQUEST FROM adjnode FAILED, SENSE=08210000 is 
received. 


Probable Cause 
When running CICS with AUTO-INSTALLATION, the terminal definition in the terminal control 
table terminal entry (TCTTE) must match the VTAM LOGMODE definition statement for the 
device. 


User Response 
Either change the VTAM LOGMODE definition statement to match the CICS TCTTE, or code 
LOGMODE=0 in the TCTTE. Adding LOGMODE=0 to the TCTTE forces CICS to use VTAM's 
LOGMODE definition statement for this session. 


Message IST663I (Sense Code 08610000) and IST264I Received for Undefined COS 
Entry 


Problem Statement 
A required COS entry is UNDEFINED. 


Common Symptoms 
The following messages are received: 
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IST663I request REQUEST FAILED, SENSE=08610000 
IST264I REQUIRED COS luname UNDEFINED 
GIS HASP208 =LOSTTERM SCHEDULED SNA, VTAM, 14 
GY JSX026 =©J003, RTNCD 1012 REQSESS/TERMSESS OPEN OPNSEC FAILED 
SENSE 08570002 
Message IST891I may be issued with the IST6631 message group and provides information 
about the identity of the node(s) involved. 
Probable Cause 
An incorrect COS table was referenced. The NetView program also has a COS table, and the 
NetView program library was concatenated in front of the VTAM library, causing the wrong table 


selection. 


User Response 
To ensure that you are using the correct table, enter: 


D NET, 1D=resourcename 


Check the library search order to ensure that there are no duplicate table names. Reassemble 
the table, and check the condition code(s). If the condition code received is what you expected, 
relink it to the table. 


Message IST718I and IST7191 Received when Activating a CDRM 


Problem Statement 
The messages IST718] and IST7191 are received during the activation of a CDRM. 


Common Symptoms 
The following messages are displayed: 
IST718I ADDRESS INVALID FOR NETID=cdrmnetid CDRM=cdrmname CODE=X'code' 
IST719I SUBAREA subarea ELEMENT el 


Probable Cause 
The message is usually a symptom of a duplicate definition for a network address. 


The duplicate may have been defined using the SUBAREA and ELEMENT parameters in 
another CDRM definition or in a GWPATH definition in a gateway NCP. 

The duplicate may have been defined using the ADJNETSA and ADJNETEL parameters in 
another CDRM definition or in a GWPATH definition. 


User Response 
If the duplicate network cannot be found by inspecting other definitions, run a VTAM internal 
trace with OPT=(NRM,MSG). When the trace is completed and IST7181 and IST7191 have been 
issued, use the console DUMP command to dump VTAM's region and CSA. 


e Locate the MSG entry for the IST7181 message in the trace. 


e Before the message entry there should be an SRTF entry with a non-zero return code, 
usually a 04. This SRTF entry points either directly or indirectly to the duplicate. 


e See “SRTx Entry for SRTADD, SRTCHG, SRTDEL, SRTFIND Macros” on page 794. 


e The SRT entry address field points to an SRT entry that can be located in the dump of 
VTAM. This SRT entry plus X'10' points to the definition that has the duplicate network 


address. 
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Messages IST154l, IST5611, IST999E, IST566I1, and IST9301I Received for APPL-APPL 
Storage Expansion Failure 


Problem Statement 
If APPL-APPL sessions are not paced at the session level, storage expansion failures can occur 
with messages IST154I, IST5611, IST999E, IST566I, and IST930!1. The job entry subsystem 
(JES) has experienced this failure. 


Common Symptoms 
The following messages are symptoms of storage expansion failures. 


IST154I EXPANSION FAILED FOR LFBUF OR IOBUF BUFFER POOL 
IST561I STORAGE UNAVAILABLE 

IST999E VTAM MESSAGE LOST—INSUFFICIENT STORAGE 

TIST5661 STORAGE UNAVAILABLE xxxx SUBPOOL xxx 

IST930I LU-LU SESSION USING 15% OF IOBUF 


Probable Cause 
If an APPL-APPL session is not paced at the session level, there is no limit to the number of 
VTAM I/O buffers that the session can use. 


User Response 
Code VPACING operands on the APPL definition statements for both applications, and code a 
non-zero value for the SSNDPAC parameter on the LOGMODE operand for the secondary LU. 
To verify pacing for the session, start a buffer trace with ID=APPLID specified before you start 
the APPL-APPL session. The BIND RU will contain the pacing values for the session. 


Missing VTAM Trace Records (MVS) 


Problem Statement 
The expected output data is missing from a VTAM trace that was run with GTF active. 


Common Symptoms 
There is no VTAM data, missing VTAM data, or unwanted data in the GTF trace data set. 


Probable Cause 
When TRACE=USR is specified, GTF collects all USR events issued in the MVS system. 


User Response 
To select the events you want to trace, specify USRP on the GTF macroinstruction and select 
the desired event identifiers (EIDs) as shown in the following examples: 


VTAM buffer EIDS—FEF FF1 FFO (EFEF EFF1 EFFO) 
VTAM line trace EIDS (not formatted by GTFTRACE)—FE4 FF2 (EFE4 EFF2) 
VTAM internal trace EID—FE1 (EFE1). 

See “Activating Network Traces” on page 349 for more information. 


Note: To prompt the system for VTAM records, specify USRP in the parameter field of the GTF 
procedure. You should code a GIF procedure that is used by VTAM only. If you do not, you 
will get GTF USR output that contains unwanted records. 
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Partial Input for TGET Received by TSO (MVS) 


Problem Statement | | 
A TSO application program receives partial input for the TGET macroinstruction. 


Common Symptoms 
The TSO application program does not receive the entire data stream buffer from a device. A 
partial buffer from a device will cause the application to enter a wait state. If the host application 
program then issues a second TGET, the second section of the buffer is returned to the host 
application program before processing for the first TGET is completed. 


Probable Cause 
The TSO application issued the set fullscreen mode (STFSMODE) macroinstruction without 
specifying the NOEDIT option. The error occurs most often after the application program sends 
a read partition query (RPQ) to the device. Many newer devices return the attribute byte X'1E' 
that is returned in the RPQ entry. TSO interprets the X'1E' as an end-of-input field mark. The 
NOEDIT option of the STFSMODE macroinstruction prevents TSO VTAM from validating the 
input data. This causes the entire buffer to be returned to the application program. 


User Response 
Verify the options on the STFSMODE macroinstruction. If STFSMODE is correct, see “Incorrect 
Output Problems” on page 121 for more information. 


Sense Code 08010000 Received with CINIT Failure 


Problem Statement 
A CINIT request fails with the sense code 08010000 if an application rejects a terminal logon 
request by issuing the CLSDST macroinstruction. 


Common Symptoms 
The following message is displayed: 


IST663I request REQUEST FAILED, SENSE=08010000 
The logon from a terminal fails with the USS message USSMSG07. 


Probable Cause 
When an SLU logs on to an application, VTAM builds a CINIT RU and schedules the LOGON 
exit routine for the application PLU. If the application is not prepared to accept a session with 
this SLU, it rejects the logon by issuing a CLSDST macroinstruction. If the application does not 
supply sense code information on the CLSDST, VTAM builds a negative CINIT response with the 
sense code 08010000. In many cases, the application will also issue a message indicating the 
reason for the logon rejection. 


User Response 
Check the message log for a message indicating a failure for this application. Run a buffer trace 
on the application name to see if the CINIT passed to the application. The VTAM internal trace 
with the API option contains data about the LOGON exit and the CLSDST macroinstruction. 
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Sense Code 081C0008 Received on ACTLINK (VM) 


Problem Statement 
Activation of an I/O device fails with sense code 081C0008. 


Common Symptoms 
The following message is displayed: 


IST380I ERROR FOR ID = nodename - REQUEST: ACTLINK, SENSE: 081C0008 


Probable Cause 
The I/O device being activated was not defined to the VTAM virtual machine. 


User Response 

1. To determine that the device exists, from the VTAM console enter: 
CP QUERY VIRTUAL vaddr 
vaddr is the virtual address for the device being activated. 

2. From a class B virtual machine enter: 
CP_ATTACH raddr vtam_userid vaddr 
raddr is the real address of the device being activated. 
vtam userid is the VTAM virtual machine's userid. 


vaddr is the virtual address that VTAM associates with the device, that is, the address specified 
by the CUADDR operand on the LOCAL, PCCU, PORT, or PU definition statement or the 
ADDRESS operand on the LINE definition statement. 


Notes: 
1. A permanent attachment may be made via the DEDICATE directory statement. 


2. See Table 80 on page 1165 to determine what book describes the DEDICATE directory state- 
ment and the CP ATTACH and CP QUERY commands. 


Sense Code 081C000C Received on ACTLINK (VM) 


Problem Statement 
Activation of an I/O device fails with sense code 081COO0C. 


Common Symptoms 
The following message is displayed: 


IST380I ERROR FOR ID = nodename - REQUEST: ACTLINK, SENSE: 081C000C 


Probable Cause 
VTAM found the device to be incorrectly defined. 


VTAM uses a CP Diagnose x'24' to determine the device type and characteristics. Table 2 contains 
_ values that VTAM checks following a Diagnose x'24' for each CUADDR defined for each type of 
major node. 


Table 2 (Page 1 of 2). Values Checked Following a Diagnose x'24' 


VTAM Major Node LNCTL Type DEVCLAS' _ DEVTYPE! DEVFTR' 
VBUILD TYPE=CA LNCTL=CTCA CTCA x'02" x'80' N/C 
VBUILD TYPE=CA LNCTL=NCP 37x5 x'02' x'40' N/C 
VBUILD TYPE=CA LNCTL=SCLC ICA x'80' x'08' N/C 
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Table 2 (Page 2 of 2). Values Checked Following a Diagnose x24 


VTAM Major Node LNCTL Type DEVCLAS! _—rdDEVTYPE! DEVFTR! 
VBUILD TYPE=CA LNCTL=BSC ICA x'80' x'40,x'80' N/C 
VBUILD TYPE=XCA N/A 3172 x02" _ x'80' | N/C 
VBUILD TYPE=LAN © N/A ICA x'02" x80 x'40 
LBUILD NIA 3270 x'40 x'01'—x'80' N/C 
VBUILD TYPE=LOCAL NAL 3x74 x'02' x'01,x'40' N/C 
VBUILD TYPE=LOCAL N/A 3820 x'10 X'4F’ N/C 
VBUILD TYPE=LOCAL N/A 3821 x'10 x'4E' NIC 
PCCU N/A 37x5 ti«é'02 x'40' NIC 
VBUILD N/A ICA N/C N/C N/C 
TYPE=PACKET 
Notes: | 


1. If a real device exists, then DEVCLAS, DEVTYPE and DEVFTR will be RDEVCLAS, REDVTYPE and RDEVFTR. 
If a real device is not presently attached, then DEVCLAS, DEVTYPE AND DEVFTR will be VDEVCLAS, 
VDEVTYPE and VDEVFTR. : 


2. RDEVFTR of x'40' on CTCA indicates that the device is a 3088. 
3. | | 

N/A not applicable 

N/C VTAM does not check this field. 

— _ indicates a range of hexidecimal values 


; indicates multiple specific values 


User Response | 
Run DIAG24 EXEC to determine the type and characteristics of a device. DIAG24 EXEC should be 
run from a CMS virtual machine to which the device in question has been temporarily attached by 
entering ATTACH rdev_ userid. DIAG24 EXEC will not run under GCS. 


If the values displayed do not match what VTAM requires, you must modify HCPRIO to achieve the 
correct values. See Table 80 on page 1165 to determine what book contains more information on 
HCPRIO. 


Figure 1 on page 23 shows sample output from DIAG24 EXEC. 


DIAG24 EXEC: 
[RRR ERE RARER RRR RERIKIAA RARER RE EERE EER ER ERR EREEEEEERE | 
/* Function: | */ 


/* The following sample exec issues a CP Diagnose x'24' */ 
/* to determine the device type and characteristics. It +*/ 
|/* then displays the output. Must be run under a CMS */ 
/* virtual machine. */ 
/* Parameter: x / 
/x Hexadecimal virtual address of the device. The device */ 
/* must be attached to the CMS virtual machine running = *«/ 
[* this EXEC. x/ 
[ RRR REKRIRRER ERE II ARR ERRIRE REA ARREA AREER ERE EERE ERERERAKEE | 
“parse upper arg vaddr 

if strip(vaddr)='' | -datatype(vaddr,'X') then 
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do 
say ‘Hexadecimal virtual address must be specified. ' 
exit 99 

end 


diag24=diagrc (24, vaddr) 
cc=substr(diag24, 11,1) 
diag24=c2x(substr(diag24,17)) 
ry=left(diag24,8) 
ryplusone=substr(diag24, 9,8) 
say 'Diag x''24'' condition code:' cc 
select 
when cc=0 then 
do /* Real device exists */ 
say 'Ry: x"'ry'"  Ry+l: x"'ryplusone'"' 
say 'RDEVCLAS: x"'substr(ryplusone,1,2)'"', 
'RDEVTYPE: x"'substr(ryplusone,3,2)'"', 
'RDEVTFR: x"'substr(ryplusone,5,2)'"' 


end /* Real device exists */ 
when cc=2 then 
do /* Virtual device exists, no realx/ 


say ‘Ry: x" ry! ne 

say 'VDEVCLAS: x"'substr(ry,1,2)'"', 
'VDEVTYPE: x"'substr(ry,3,2)'"', 
'VDEVFTR: x"'substr(ry,5,2)'"' 


end /* Virtual device exists, no real*/ 
when cc=3 then 
do /* Device not attached x/ 
say 'Device:' vaddr 'is not ATTACHed to this virtual', 
‘machine. ' 
end /* Device not attached */ 
otherwise 


end 

say 'See VM/ESA CP R2 Programming Services under appendix C,' 
say '"Data Areas Used by DIAGNOSE Codes" in topic C.0' 

exit 


- diag24 009 


Diag x'24' condition code:0 
Ry: x"80000000" Ry+1: x"40010350" 


RDEVCLAS: x"40" RDEVTYPE: x"01" RDEVFTR: x"03" 

See VM/ESA CP R2 Programming Services under appendix C, 
"Data Areas Used by DIAGNOSE Codes" in topic C.0 

Ready; T=0.01/0.01 15:30:53 


Figure 1. Sample DIAG24 EXEC Output 


In the sample shown in Figure 1, RDevice class of x'40' and RDevice type of x'01' indicates that this 
device would be valid for an LU under an LBUILD major node. 


Sense Code 083500xx or 08210000 Received with BIND Failure 


Problem Statement 
BIND failure occurs with sense code 083500xx or 08210000. 


Common Symptoms 
The following messages are displayed in response to a terminal logon request: 
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IST663I BIND REQUEST FAILED, SENSE=083500xx 
or 
IST663I BIND REQUEST FAILED, SENSE=08210000 
and 
USSMSGO7 luname UNABLE TO ESTABLISH SESSION—BIND FAILED 
WITH SENSE sense 


Probable Cause 
The sense codes indicate that the BIND contains parameters that are not valid. The sense code 
08210000 gives no further explanation. Sense code 083500xx supplies an index (xx) into the 
BIND that identifies the bytes that the BIND receiver cannot interpret. 


VTAM extracts BIND parameters from the LOGMODE entry associated with the logon, based on 
the LOGON command, the USSPARM PARM=LOGMODE from the USSTAB, or the default on 
the LU definition specified by DLOGMOD. The source of the BIND parameters can also be the 
application, which may override many of the parameters supplied by VTAM when the OPNDST 
macroinstruction is issued. When the requested LOGMODE cannot be found, VTAM may use a 
default LOGMODE (ISTCOSDF), which may contain session parameters that are unacceptable 
to the application. 


User Response 
Run a buffer trace on the application name for a terminal session logon to an application that is 
rejected by the BIND with a sense code of 083500xx or 08210000. This traces the CINIT 
request, which includes the VTAM supplied parameters. If the BIND that follows the CINIT 
request does not match these parameters, they were changed by the application. The documen- 
tation for the rejecting LU should list its required BIND parameters. 


In order to prevent VTAM from using the default LOGMODE (ISTCOSDF), ensure that the 
requested LOGMODE is defined in the specified LOGMODE table. See the VTAM Network 
Implementation Guide and “Subarea Class-of-Service Table” in the VTAM Resource Definition 
Reference for more information on ISTCOSDF. 


Sense Code 800A0000 or No Message, and Sessions End Unexpectedly 


Problem Statement 
A session ended unexpectedly and either no message is received or an exception request (EXR) 
with a sense code of 800A0000 flows to the destination LU. 


Common Symptoms 
Upon receiving the sense code 800A0000, the LU might return the code in a response. Some 
LUs will include the code in an UNBIND. 


Probable Cause 
lf a path information unit (PIU) is too large to be passed from one PU type 4 or 5 to another, an 
exception request (EXR), containing sense code 800A0000 and up to three bytes of the RU, may 
be generated. See Table 80 on page 1165 to determine what book describes the building of 
the EXR. 


User Response | 
For VTAM/NCP nodes in the session path, the following definition values should be checked for 
each configuration used: 


e VTAM to channel-attached NCP: VTAM will take the smaller of the following two values: 


— MAXDATA value on the PCCU definition statement (or on the LINE definition statement 
for a channel-attached NCP) 


— Value sent in the XID of the maximum PIU size for the NCP. This number will be the 
product of the BFRS value from the BUILD definition statement and the TRANSFER 
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value from the channel adapter LINE definition statement for 3745 or 3720 with V5 NCP 
or from the BUILD definition statement for other NCPs. 


e Channel-attached NCP to VTAM: The product of the MAXBFRU value from the HOST defi- 
nition statement (or from the LINE definition statement for a channel-attached NCP) and the 
lIOBUF size from the VTAM start options. This value will be the maximum size that can flow 
from the NCP to the host. 


e VTAM-to-VTAM connection across a channel-to-channel interface: 


— If both VTAMs have the CTCA enhancement: The product of the MAXBFRU value from 
the CTCA LINE definition statement and the IOBUF size from the VTAM start options 


— If one or neither of the VTAMs have the CTCA enhancement: The product of the 
MAXBFRU value from the LINE macro and the IOBUF size from the VTAM start options 


e NCP to link-attached NCP: The product of the TRANSFR value on the LINE definition state- 
ment and the BFRS value on the BUILD definition statement 


e NCP to link-attached VTAM: The product of the MAXBFRU value from the CA LINE defi- 
nition statement and the IOBUF size from the VTAM start options. 


Notes: 


1. The definition statements for all PU type 4 or 5 nodes on the session path must be checked 
because any PU type 4 or 5 can change the PIU into an 800A0000 exception request. 


2. The information in this problem description is from information APAR 1103990. 


Sense Codes 10030000 and 08090000 Received when Activating an NCP 


Problem Statement 
Some resources fail to activate correctly when a new NCP is activated. 


Common Symptoms 
VTAM commands return sense codes 10030000 and 08090000. 


Probable Cause | 
The resource resolution table (RRT) created when a new NCP was generated did not replace 
the previous RRT, and the old RRT is still being referred to by the system. 


User Response 
When you generate a new NCP, either rename the new NCP or use another method to ensure 
that the old RRT is replaced with the new RRT. 


Session Failure with Sense Code 0888000x 


Problem Statement 
An attempt to establish a session fails with sense code 0888000x in an intermediate VTAM along 
the session setup path. 


Common Symptoms 
The session establishment is terminated. 


Probable Cause 
The intermediate VTAM that set the 0888000x sense codes is operating with NQNMODE=NAME 
or is a pre-V4 VTAM and therefore cannot define multiple resources with the same name, even if 
the network identifiers are different. 
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User Response 7 
Change the intermediate domain to operate with NQNMODE=NQNAME to allow definition of 
multiple resources with the same name and different network identifiers, or reroute the session 
through another path. 
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Common Problems in APPN Networks 


Table 3 includes a brief description of several common problems that occur in APPN networks. For addi- 


tional information, go to the page indicated. 


Table 3 (Page 1 of 2). Index of Common Problems in APPN Networks 


Problem See 
Best path not taken for the session Page 38 
Message IST489I received during session takeover Page 28 
Message IST264I (required COS entry undefined) and message IST6631I (sense code 08610000) Page 29 
Message IST663l (sense code 08610000) and message IST264I (required COS entry undefined) Page 29 
Messages IST1097I and IST1280I (sense code 08A00005) received with CP-CP session failure Page 29 
Messages IST1110I and IST1112I issued during CP-CP session activation failure Page 30 
Messages 1ST1110I and IST11131 issued during CP-CP session activation failure Page 30 
Messages IST1110I and IST1246I issued during CP-CP session activation failure Page 31 
Messages IST11101I, IST12461, and IST12801 (sense code 80050000) issued during CP-CP session Page 31 
activation failure | 
Messages IST1110I and IST1280! (sense code 08B50000) issued during CP-CP session activation Page 32 
failure | 

Messages IST1110I and IST1280! (sense code 08910006) issued during CP-CP session activation Page 32 
failure | 

Messages IST1110I, IST12801 (sense code 101E000A), and IST1356I issued during CP-CP session Page 31 
activation failure 

Message IST1272I received during session takeover Page 28 
Resource not found but resource exists in network Page 33 
Sense code 081C0008 Received on ACTLINK Page 21 
Sense code 081C000C Received on ACTLINK Page 21 
Sense code 08210002 issued during a session activation failure Page 33 
Sense code 0821000A issued during a session activation failure Page 34 
Sense code 083B0001 issued and session lost Page 35 
Sense code 08610000 (message IST6631) and message IST264I (required COS entry undefined) Page 29 
sense code 087D0001 issued during a session activation failure Page 34 
Sense code 087D000A issued and session lost Page 35 
Sense code 08910006 and messages IST1110I and IST1280I issued during CP-CP session acti- Page 32 
vation failure 

Sense code 08A00005 received unexpectedly with CP-CP session failure Page 29 
Sense code 08B50000 and messages !IST1110! and IST1280I issued during CP-CP session acti- Page 32 
vation failure 

Sense code 10145046 (AS/400") issued during a session activation failure Page 35 
Sense code 101E000A and messages IST11101, IST12801, and IST1356I issued during CP-CP Page 31 
session activation failure 

Sense code 80050000 and messages IST1110!, IST1246!, and IST12801! issued during CP-CP Page 31 
session activation failure 

Sense code 80130000 issued during a session activation failure Page 36 
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Problem See 
Sense code 80130104 and path problems Page 199 
Sense code 80140001 issued during a session activation failure Page 36 
Sense code 80140002 issued during a session activation failure Page 37 
Sense code 80140005 issued during a session activation failure Page 37 
Session did not take the best path Page 38 
Session established with non-local instead of local application program Page 38 
Session lost with sense code 083B0001 Page 35 
Session lost with sense code 087D000A Page 35 
Storage problem Page 105 


Descriptions of Common Problems in APPN Networks 


This section includes examples of common problems in APPN networks. See Table 3 on page 27 for an 


index of these problems. 


Message IST489I or IST1272I Received during Session Takeover 


Problem Statement 


Message IST4891 or IST1272I is received, indicating that VTAM cannot define a resource. 


Common Symptoms 


Message IST489I or IST1272I is received for a resource during takeover processing. The 


resource can be a dependent LU. 


Probable Cause 


A scenario similar to the following can cause this problem: 


r--—-—  Subarea | 
Composite Connection 
Network —>| 
Node 


APPN 
Connection 


CP-CP 

Session L 
Over APPN ————> 
Connection 


SSCP-SSCP 
<«— Session 


¢ Boundary function CP-CP sessions exist between SSCP1 and SSCP2. There is also a FID4 


connection between SSCP2 and NCP1. 


e There is an SSCP-SSCP session between SSCP2 and SSCP3. 
e Dependent LU1, connected from NCP1, is owned by SSCP1. 


e An LU-LU session is between LU1 and LU2. LU1 is known to SSCP2 as an APPN LU 
through the APPN connection between SSCP1 and SSCP2 through NCP1. 
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e The command, VARY INACT TYPE=G, was entered from SSCP1 which caused session 
takeover of the line from SSCP1 to SSCP2. SSCP2 owns LU2, the independent LU. 


The failure, triggering message IST489I or message IST1272I, occurred because LU1 is known 
to the SSCP2 host as an independent APPN LU. SSCP2 cannot own the independent LU and 
the dependent LU at the same time. 


User Response 
The independent LU is freed when the last session ends. After this occurs, you must activate 
the dependent LU before it can be enabled. 


Message IST6631 (Sense Code 08610000) and IST264I Received for Undefined COS 
Entry 


Problem Statement 
A required COS entry is UNDEFINED. 


Common Symptoms 
The following messages are received: 


IST663I request REQUEST FAILED, SENSE=08610000 

IST264I REQUIRED COS luname UNDEFINED 

is ee LOSTTERM SCHEDULED SNA, VTAM, 14 

MRS JSXO26 J003, RTNCD 1012 REQSESS/TERMSESS OPEN OPNSEC FAILED 
SENSE 08570002 


Message IST891I may be issued with the IST663! message group and provides information 
about the identity of the node(s) involved. 


Probable Cause 
An incorrect COS table is referenced. The NetView program also has a COS table, and the 
NetView program library was concatenated in front of the VTAM library, causing the wrong table 
selection. 


User Response mode-to-class-of-service (COS) 
To ensure that you are using the correct table, enter: 


D NET, 1ID=resourcename 


Check the library search order to ensure that there are no duplicate table names. Reassemble 
the table, and check the condition code(s). If the condition code received is what you expected, 
relink it to the table. 


Messages IST10971 and IST12801 (Sense Code 08A00005) Received with CP-CP 
Session Failure 


Problem Statement 
CP-CP session failure occurs with sense code 08A00005. 


Common Symptoms 
The following message group is received: 


IST10971 CP-CP SESSION WITH partner _cpname TERMINATED 
IST12801 SESSION TYPE = CONLOSER - SENSE = 08A00005 
IST3141I END 


Probable Cause: 
lf CP-CP sessions have been deactivated with this sense code, it is likely that the topology data- 
base update (TDU) flowing between the two nodes has been lost due to a storage depletion 
condition on either the sending or receiving end of the TDU flow. 
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User response 
If the CP-CP sessions do not come back up automatically, enter: 


V ACT, 1D=partner_cpname, IDTYPE=CP 


If VTAM is experiencing temporary storage allocation problems, yous might want to wait for the 
condition to clear before attempting to restart the session. 


When the CP-CP session is restarted, TDUs will be exchanged so that the missing information in 
the lost flow will be recovered. 


Messages IST11101 and IST11121 Received during CP-CP Session meuvenon 
Failure 


Problem Statement 
End node operator's attempt to activate CP-CP session pair by activating adjacent network node 
fails with issuance of messages IST11101, IST1112I, and IST3141 at the end node. 


Common Symptoms 
Activation of new CP-CP session pair with adjacent CP specified in message IST1110I is termi- 
nated. Messages IST1110I, 1ST11121, and IST3141 are displayed. 


Probable Cause ; 
While attempting to activate a contention winner CP-CP session with the network node specified 
in 1IST11101, the end node determined that it already had an active CP-CP session pair with a 
different network node. If an end node already has a network node server, it will not accept a 
new CP-CP session with another network node. 


User Response 
Before attempting to activate a CP-CP session pair between an end node and a network node, 
enter the D NET,SESSIONS,LIST=ALL command at the end node to verify that no CP-CP ses- 
sions with a network node already exist. 


Messages IST11101 and 1ST11131 Received during CP-CP Session Activation 
Failure 


Problem Statement 
Attempt by operator of end node to activate CP-CP session pair with adjacent network node by 
activating adjacent network node fails with issuance of messages IST1110I, IST1113!, and 
IST3141. 


Common Symptoms 
Activation of new CP-CP session pair with adjacent CP specified in message IST1110I is termi- 
nated. Messages IST1110I, iST1113l, and IST3141 are displayed at the end node. 


Probable Cause | 
The operator entered from an end node a V NET,ACT,ID=cpname command, where cpname is 
also an end node. CP-CP sessions are not permitted between end nodes. 


User Response 
Make sure that the start lists for the two nodes do not both specify end node as the type of node 
being started. 
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Messages IST1110I and IST1246I Received during CP-CP Session Activation 
Failure 


Problem Statement 
Attempt to activate CP-CP session pair between end node and network node fails after activation 
of CP-capable link. 


Common Symptoms 
Activation of new CP-CP session pair with network node specified in message IST1110I is termi- 
nated. Message IST1110I displayed along with message IST1246l at the end node. 


Probable Cause 
While in the process of bringing up the contention winner CP-CP session, the end node deter- 
mined that the network node named in IST1110I is not explicitly named in the end node's 
network node server list and that there is no nameless entry in the network node server list. 


User Response 
Either perform an operator activation of the CP-CP session by entering 
V NET,ACT,ID=adjacent_cpname at the end node or modify the network node server list to 
include either an explicit entry for the desired network node or a nameless entry. 


Messages IST11101, IST1246I, and IST12801 Received during CP-CP Session Acti- 
vation Failure 


Problem Statement 
Attempt to activate CP-CP session pair between end node and network node fails. 


Common Symptoms 
Activation of new CP-CP session pair with network node specified in message IST1110! is termi- 
nated. Message IST1110! displayed along with message IST1246l at the end node. Message 
IST12801 displays a sense code of 80050000. 


Probable Cause 
While in the process of bringing up the conloser CP-CP session, the end node determined that 
the network node named in IST1110I is not explicitly named in the end node's network node 
server list and that there is no nameless entry in the network node server list. 


User Response 
Either perform an operator-activation of the CP-CP session by entering V 
NET,ACT,ID=adjacent_cp_name at the end node or modify the network node server list to 
include either an explicit entry for the desired network node or a nameless entry. 


Messages IST1110I, IST1280I (Sense Code 101E000A), and IST13561 Received 
during CP-CP Session Activation Failure 


Problem Statement 
Attempt to activate CP-CP session pair between end node and network node fails. 


Common Symptoms 
Activation of new CP-CP session pair with network node specified in message IST1110! is termi- 
nated. The operator at the end node sees messages IST1110I, IST12461, IST1280I, and 
IST314I. IST12801 displays a sense code of 101EQOOA. 


Probable Cause 
The end node's network node server list entry for the network node failed to specify 
SLUINIT=OPT or, in the absence of an explicit entry for that node, the nameless entry failed to 
specify SLUINIT=OPT. The network node is probably an AS/400, NS/2, or Personal System/2° 
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computer, none of which provides the network node server capabilities provided by VTAM 
Version 4 network nodes. CP-CP sessions between VTAM Version 4 end nodes and such 
network nodes are allowed only if the end node's network node server list specifies 
SLUINIT=OPT. 


User Response | 
Modify the network node server list to specify SLUINIT=OPT on either the explicit entry for the 
desired network node server or on the nameless entry. Activate the modified network node 
server list definition deck, and then reactivate the session. 


Messages IST11101 and IST12801 (Sense Code 08910006) Received during CP-CP 
Session Activation Failure 


Problem Statement 
Attempt to activate CP-CP session pair between network nodes in two different network nodes 
fails. 


Common Symptoms 
Activation of new CP-CP session pair between this network node and adjacent network node 
specified in message IST1110I is terminated. 


Probable Cause 
A CP-CP session pair is not permitted between network nodes located in different networks 
unless you have specified BN=YES to enable the VTAM border node function. The messages 
indicate that CP-CP sessions were attempted between two network nodes in different networks. 


User Response 
Modify the VTAM start lists for the specific nodes so that both start lists specify the same 
network. 


Messages IST11101 and IST1280!1 (Sense Code of 08850000) Received during 
CP-CP Session Activation Failure 


Problem Statement 
Attempt to activate CP-CP session pair between end node and network node fails with sense 
code 08B50000, as indicated by message IST1280I. 


Common Symptoms | 
Activation of new CP-CP session pair with adjacent CP specified in message IST1110I is termi- 
nated. Message IST1110I is displayed along with message IST1280I, which displays a sense 
code of 08B50000. 


Probable Cause 
The sense code indicates that the end node bringing up the contention-loser session does not 
require a CP-CP session pair with the network node specified in message IST1110I. The end 
node determined that it has an active CP-CP session with a different network node. If an end 
node already has a server, it will not accept a new CP-CP session with another network node. 


User Response 
Before attempting to activate a CP-CP session pair between an end node and a network node, — 
enter the D NET,SESSIONS,LIST=ALL command at the end node to verify that no CP-CP ses- 
sions with a network node already exist. 
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Resource Not Found but Resource Exists in Network 


Problem Statement 
A resource exists in the network but is not found by a search. 


Common Symptoms 
The directory services management exit routine either rejects or limits the search scope. 


Probable Cause 
The resource was not registered to its network node server. 


User Response 
Register the resource to the network node server. For more information on the directory ser- 
vices management exit routine, see “Directory Services Management Exit Routine” in VTAM 
Customization. 


Sense Code 08210002 Received with Session Activation Failure 


Problem Statement 
Session activation failed with the sense code 08210002. 


Common Symptoms 
An attempt to establish a session failed with the sense code 08210002 - invalid mode name. 


Probable Cause 
The sense code indicates that the logon mode name associated with the session request was 
not found in the table or in the default logon mode table (ISTINCLM). 


User Response 
Verify that the requested logon mode name is defined as follows: 


e In a subarea-only environment, the mode name must be defined in the SSCP associated 
~ with the SLU. 


e In an APPN-only environment, the mode name must be defined in the origin and destination 
nodes, as well as the origin and destination node servers if the origin or the destination is 
owned by an end node. 


e In a combined APPN and subarea environment, the mode name must be defined at the 
APPN node that owns the origin or destination, at the node server if it is an end node, and at 
the interchange nodes that represent the subarea entry point. If the SLU is owned bya 
subarea node other than the interchange node representing the subarea entry point, the 
mode name must also be defined on the owning subarea. 


Note: Since mode table names are not carried on APPN line flows, a user-defined mode 
table is only used at the SSCP for the SLU. Other nodes defining the mode must define the 
SLU in the default logon mode table. 


See “What do you get if you take all the defaults?” in the VTAM Network Implementation 
Guide for details on mode to COS resolution in an APPN or in a combined subarea and 
APPN environment. 
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Sense Code 0821000A Received with Session Activation Failure 


Problem Statement 
Session activation failed with the sense code 0821000A. 


Common Symptoms 
An attempt to establish a session failed and the sense code 0821000A (mode table not found) 
was returned. | | 


Probable Cause 
The sense code indicates that the mode table associated with the LU was not found. 


User Response 
Verify that the specified table exists, and activate it. 


Sense Code 087D0001 Received with Session Activation Failure 


Problem Statement 
Session activation failed with the sense code 087D0001. 


Common Symptoms 
An attempt to establish a session failed and the sense code 087D0001 (routing exhausted) was 
returned. Messages IST894 and IST895 indicate that one of the adjacent SSCPs tried is 
ISTAPNCP with a failure sense code of 087F0001 (resubmit requested for a request that was 
already resubmitted). 


Probable Cause 
Possibly one of the following: 


e If messages IST894I and IST895i are issued, one of the adjacent SSCPs was ISTAPNCP 
with a failure sense code of 087F0001. This indicates that VTAM knows which node owns 
the LU but is not able to route a directed search to that node to verify the availability of the 
LU. 


e There is no SSCP-SSCP session. 


e The half-session contro! block (HSCB) count is too low in the NCP to handle the number of 
sessions. A possible solution to this problem is to code a larger value on the ADDSESS 
keyword of the BUILD definition statement and regen. 


e Both sides are using the same SSCP name. 


User Response | 
Verify that a valid search path exists. This includes CP-CP sessions, a subarea path, or both. 
One possible source of the problem is the absence of a CP-CP session between two nodes that 
share an active link that is CP-CP capable. If this situation occurs, take one of the following 
actions: | 


e Reactivate the CP-CP session. 


e Deactivate the link, and reactivate it as a link that is not CP-CP capable. This notifies 
topology and routing services that the link is no longer available for use in directed search 
routing. 


34 VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” Common Problems and Symptoms 
Licensed Materials — Property of IBM 


Sense Code 087D000A or 083B0001 Received and Session Lost during Takeover 


Problem Statement 
Session lost during takeover with sense code 087D000A or 083B0001. 


Common Symptoms 
An attempt to take over a switched connection that is defined with ANS=CONTINUE results in a 
session or sessions being lost. A message states that a BFSESSINFO request failed with the 
sense code 087D000A (routed through same SSCP twice) or with the sense code 083B0001 
(duplicate PCID). 


Probable Cause 
The problem might be that a connection-network-capable control point (CP) on the connection 
network does not have a complete system definition. 


User Response | 
If you have a connection network, check the resource definitions on each CP connected to the 
network. Any connection-network-capable CP must define both of the following: 


e Its own connection to the connection network 
e Connections to any CPs on the connection network that are not connection-network-capable. 


Sense Code 10145046 Received with Session Activation Failure 


Problem Statement 
Session activation failed with the AS/400 sense code 10145046. 


Common Symptoms 
An attempt was made to establish a session from one AS/400 to another AS/400 across a VTAM 
network. The session failed to complete, and route selection errors occurred on the initiating 
AS/400. 


Probable Cause 


AS/400 VTAM AS/400 


NETC NETA NETB 


The AS/400 (NETC) is sending VTAM (NETA) a CDINIT that specifies a session in a third 
network that is not supported in this release of VTAM. VTAM rejects the session, and the 
AS/400 returns the sense code 10145046 to VTAM. 


User Response 
Verify that APPN sessions across three networks are not present in your system. Sessions 
across three networks using APPN links are not supported by VTAM unless you have specified 
BN=YES to enable the VTAM border node function. 
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Sense Code 80130000 Received with Session Activation Failure 


Problem Statement 
Session activation failed with the sense code 80130000. 


Common Symptoms 3 | 
An attempt to establish a session failed, and the sense code 80130000 (class of service not 
available) was returned. 


Probable Cause 
This sense code indicates that the subarea class of service (COS) is not known. (In contrast, 
sense code 80140002 is issued by topology and routing services and indicates that the APPN 
COS is not known.) 


User Response | | 
Verify that the node issuing the sense code has a usable subarea class of service for the mode 
associated with the session request. This node is usually the primary logical unit (PLU) host, an 
intermediate gateway VTAM, or a gateway VTAM. 


Message IST891I may be issued and provides the name of the failing node. See the description 
of message IST891I in VTAM Messages and Codes for additional information. 


This problem can occur when a mode table is copied from one node to another, and the subarea 
classes of service specified by the table no longer map to valid COS names defined at that 
node. 


Sense Code 80140001 Received with Session Activation Failure 


Problem Statement 
Session activation failed with the sense code 80140001. 


Common Symptoms 
An attempt to establish a session failed, and the sense code 80140001 (no route exists) was 
returned. This sense code indicates that no APPN route was found from the origin node to the 
destination node that meets the requirements of the requested class of service. 


This can be due to any of several possible causes. 


Probable Cause 1 
There is not an active APPN route between the origin and destination. 


User Response 1 
Examine your network configuration to determine whether a valid path does exist. Use the 
DISPLAY TOPO command to verify that the topology database currently shows the links in the 
path as operational. 


Probable Cause 2 
Although a valid APPN path exists, the characteristics of the nodes and links in the operational 
paths do not meet the requirements of the specified class of service. 


User Response 2 
Check the following: 


1. Verify that the mode name specified on the request maps to the intended class of service. 


2. Examine the LINEROW and NODEROW operands in the class of service definition to deter- 
mine the allowable ranges for the link and node characteristics. | 


3. Use the DISPLAY TOPO command to view the characteristics of the nodes and TGs in the 
likely paths. Look for problems such as: 
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a. Nodes in the path are congested or have route resistance values outside the limits set 
by the class of service. 


b. The COS definition required secure links, but no path exists consisting exclusively of 
secure TGs. 


c. High capacity (speed) was required by the COS definition, but no path exists in which all 
of the links are fast enough to meet the specified minimum capacity. 


Probable Cause 3 
The destination exists in a subarea network, or in another APPN network that is accessed 
through a subarea network, but paths acceptable to the specified class of service definition do 
not exist to all interchange nodes representing subarea entry points that can be used to reach 
the destination. 


User Response 3: 
As specified in “APPN and Subarea Class of Service Resolution” in VTAM Network Implementa- 
tion Guide, if a destination can be reached by exiting one APPN network through two or more 
different interchange nodes, paths acceptable for the class of service to be used must be avail- 
able to all of those possible exist interchange nodes. Verify this by examining the COS definition 
and the characteristics of the paths to the possible exit interchange nodes. 


Sense Code 80140002 Received with Session Activation Failure 


Problem Statement 
Session activation failed with the sense code 80140002. 


Common Symptoms 
An attempt to establish a session failed, and the sense code 80140002 (invalid APPN COS. 
name received) was returned. 


Probable Cause 
The sense code indicates that the APPN COS definition was not found. The definition might not 
exist at a node that is performing mode-to-COS resolution, or the mode-to-COS mapping speci- 
fied in the mode table might not be mapping to the intended COS name. 


User Response 
Examine the mode definition to determine the APPN COS name. Verify that this definition exists 
in the VTAMLST members at the nodes that resolve the mode to an APPN class of service. 
Activate the member to be sure that the definition is active. If APPN COS substitution is enabled 
(by specifying the APPNCOS start option), verify that the COS it specifies has been activated. 


Sense Code 80140005 Received with Session Activation Failure 


Problem Statement 
Session activation failed with the sense code 80140005. 


Common Symptoms 
An attempt to establish a session failed, and the sense code 80140005 (RSCV exceeds the 
maximum length) was returned. 


Probable Cause 
The sense code indicates that the number of hops between the origin and destination nodes was 
too large, so the attempt to build the Route Selection control vector failed. 


User Response 
Examine your network configuration to determine how many hops would be expected in the best 
route for the requested APPN class of service. If the number of hops within a single APPN 
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‘network is greater than six, then you may need to provide a more direct origin to the destination 
path. : 


Session Established with Non-Local instead of Local Application Program 


Problem Statement 
The session was intended to be established with a local application program; however, it was 
established with a non-local application program. 


Probable Cause vk 
The local application program is not yet active, and a local application program served by 
another node is registered to the non-local application program's network node server. 


User Response 
Be sure that the local application program is active before you attempt to logon to it. 


Session Did Not Take the Best Path 


Problem Statement 
The session took a path through the subarea network even though a better path existed through 
the APPN network, or the session took a path through the APPN network even though a better 
path existed through the subarea network 


Probable Cause 
The SORDER operand or SSEARCH operand is coded with a value that indicates that the 
subarea network is to be searched before the APPN network is searched or that the APPN 
network is to be searched before the subarea network is searched. 


User Response 
Adjust the values on the SORDER and SSEARCH operands to suit your network. 
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Common Problems and Symptoms 


Common Symptoms and Associated VTAM Problem Types 
If your problem was not described in “Common Problems in Subarea Networks” on 
page 6 or “Common Problems in APPN Networks” on page 27, find the symptom 
you are experiencing in Table 4. The symptoms are listed alphabetically. Match 
your symptom to the appropriate VTAM problem type and go to the page indicated. 


Table 4 (Page 1 of 3). Index of Problem Symptoms and Associated VTAM Problem Types 


Symptom 

Abend message 

Activating network nodes takes too long 
Application program cannot terminate 


Application programs and terminals cannot communicate 
Application program reports an unexpected return or sense code 


Batch application program fails to complete 


‘Book is missing information or has wrong or ambiguous informa- 
tion 


Books contradict each other 


Command is not completed 


Commands cannot be entered on system console 
Commands take too long to complete 


Cursor is in the wrong position. This is probably an application 
program or VTAM definition error, such as using an incorrect 
logmode definition. 


Deactivating network nodes takes too long 
DTI error message 


DTI message is wrong or formatted improperly 


DTIS99I message appears 
Dump file contains a VTAM or TSO/VTAM dump 


Error message 

Hung session, LU, or terminal 

Hung system 

IKT error message 

IKT message is wrong or formatted improperly 


Initialization problem (VSCS only) 
Internal error message (VSCS only) _ 
IST error message 


IST message is wrong or formatted improperly 
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Problem Type 
Abend 
Performance 
Wait 

Wait or Loop 


Incorrect Output or Message 


Wait 


Documentation 


Documentation 


Wait or Incorrect Output 


Loop 
Performance 


Incorrect Output 


Performance 


_ Message 


‘Message or Incorrect Output 


See chapter 131 
Abend or Program Check 


Message 
Incorrect Output 
Wait 

Message 


Message or Incorrect Output 


Message 


Message or Incorrect Output 


See 

Page 
Page 
Page 


Page 
Page 


Page 
Page 


Page 
Page 


Page 


Page 
Page 


Page 
Page 
Page 


Page 
Page 


Page 
Page 


Page 


Page 
Page 


Page 
Page 
Page 
Page 


Page 
Page 


Page 
Page 
Page 


Page 
Page 


58 
101 
67 


67 
86 


96 
93 


67 
108 


108 


67 
96 


86 
101 
96 


101 
93 


93 
96 


176 


58 
63 


93 
96 
67 
93 


93 
96 


143 
176 
93 


93 
96 
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Table 4 (Page 2 of 3). Index of Problem Symptoms and Associated VTAM Problem Types 


Symptom 

IST2521 message appears 

IST413l message appears 
Keyboard locks unexpectedly 

Logo problem 

LOGON takes too long to complete 
LOGREC entries indicate an abend 
LOGREC fills with repeated entries 


Message is wrong or formatted incorrectly 
Message from application program 


Message is sent to the wrong console 
Message repeats continuously 
Message text does not explain a condition 


Message is missing text 


Output data is formatted incorrectly. This is probably an application 
program or VTAM definition error, such as using an incorrect 
logmode definition. 


Path problem 

Performance is degraded after a network outage 
Printers stop 

Program check message 

PSWs point to a VTAM address 

Response time is slow 

Routing information is wrong 

Storage message IST154! or IST5611I-IST566I 
SYSREC entries indicate a program check 
SYSREC fills with repeated entries 
System enters disabled wait state 


System functions stop 

System light is on; Wait light is off 

Tapes stop | 

Terminal user cannot log on, enter data, or log off 


Terminal user gets unexpected response. This is probably an 
application program or VTAM definition error, such as using an 
incorrect logmode definition. 


Terminal user reports incorrect or missing data. This is probably 
an application program or VTAM definition error, such as using an 
incorrect logmode definition. 
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Problem Type 
Program Check 
Abend 

Incorrect Output 
Incorrect Output 
Performance 
Abend 

Loop or hardware 


Message or Incorrect Output 
Incorrect Output or Message 


Incorrect Output 
Loop 
Message 


Message or Incorrect Output 


Incorrect Output 


Performance 
Performance 
Loop 

Program Check 
Loop 
Performance 
Incorrect Output 
Storage 

Program Check 
Loop or Hardware 


Program Check or Incorrect 
Output 


Loop 
Loop 
Loop 
Incorrect Output 


Incorrect Output 


Incorrect Output 
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See 

Page 63 
Page 58 
Page 96 
Page 96 
Page 101 
Page 58 
Page 86 


Page 93 
Page 96 


Page 96 
Page 93 


Page 96 
Page 86 
Page 93 
Page 93 


Page 96 


Page 96 


Page 199 
Page 101 
Page 86 
Page 63 
Page 86 
Page 101 
Page 96 
Page 105 
Page 63 
Page 86 


Page 63 
Page 96 


Page 86 
Page 86 
Page 86 
Page 96 
Page 96 


Page 96 
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Table 4 (Page 3 of 3). Index of Problem Symptoms and Associated VTAM Problem Types 


Symptom Problem Type See 
Termination problem (VSCS only) Page 150 
Traffic ceases through a network component (BSC link, SDLC link, Wait Page 67 
communication controller, control unit) 
VTAM does not work as described in a book Documentation Page 108 
VTAM is not communicating with system console Wait or Loop Page 67 
Page 86 
VTAM process issues an error message Message Page 93 
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VTAM Internal Trace (VIT) Analysis Tool Problems (MVS) (VM) 


This section describes how to diagnose problems that might occur while running 
the VIT analysis tool and includes the following sections: 


e “Checklist for Isolating the Problem” 
e “Common Symptoms and Actions” on page 43 
e “Documenting an APAR for VIT Analysis Tool Problems” on page 44. 


If you are having problems during installation of the tool, refer to “Installing the 
VTAM Dump Analysis Enhancements and the VIT Analysis Tool” in the VTAM 
Network Implementation Guide for additional information. 


Checklist for Isolating the Problem 
1. Does the problem exist with an ISPF panel or with the VIT analysis tool? 


The ISPF panel process simply creates the parameter data set, which is the 
input to the VIT analysis tool. 


2. Are any errors noted in the JCL output? 


IBM publishes sample JCL, as described under “Step 2. Set up to Run the 
Tool” on page 412. However, you can change it to suit your environment. The — 
JCL output indicates whether the tools' entry module, ISTRAFT1, is found. The 
JCL output contains an error message if the SUMMARY data set cannot be 
written to (for example, if the wrong DCB information was specified for the 
SUMMARY data set). Also check the JCL to verify that the right trace tapes or 
DASD data sets are specified and that multiple tapes are specified in the 
correct order. 


3. Check the SUMMARY data set to determine whether any errors were noticed, 
such as the wrong DCB information being supplied for the LOG data set. 


The SUMMARY data set tells the input parameters and defaults used. The 
SUMMARY data set reports time stamps and types of records and VIT entry 
-occurrences found on the trace. The SUMMARY data set should always be 
created, unless there was a problem with the SUMMARY data set itself, in 
which case the JCL or REXX output shows what happened. 


4. Check the input parameters in the parameter data set with the syntax dia- 
grams. 


The parameter data set is created by either the ISPF panel process or by 
coding the parameters directly using an editor. For more information on 
checking syntax diagrams, see Chapter 10, “Using the VIT Analysis Tool (MVS, 
VM)” on page 411. 


5. Check the following output data sets: 
e LOG 


The LOG data set shows whether counters overflowed, whether the trace 
wrapped, and so on. The LOG data set is always used unless a fatal error 
prevents the tool from initializing completely. The LOG data set might 
contain only the title line and description (if a description exists). 
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e VITEXT 


The VITEXT data set is used only if the VIT extraction function is chosen. 
It is not used for storage analysis or RU-counting. 


e DETAILS 


The DETAILS data set is used only if the storage analysis or RU-counting 
function is chosen. It is not used for VIT extraction. 


e OUTSTAN 


The OUTSTAN data set is used only if storage-analysis-counting function is 
chosen and only if the outstanding option (to list unmatched allocate 
entries) is chosen. It is not used for RU counting or VIT extraction. 


Common Symptoms and Actions 


Use Table 5 to diagnose and correct problems. 


Table 5 (Page 1 of 2). VIT Analysis Tool Problems: Common Symptoms and Actions 


Symptom 


Runs too long 


No output 


Same output 
from a previous 
date 


Action 
If the tool is taking a very long time to run (Several hours): 


e If the MATCH option was specified for storage analysis: 
— Remove the MATCH option. 
— Specify only the few pools you are interested in when using the MATCH option. 
e Check to see if the tool is waiting on a tape to be mounted or to access a data set in use by 
some other job. 


If no output appears (for example, no matching VIT entries are found, no RUs are counted, no 
storage VIT entries are found): 


e Verify that the trace has VIT records (see the SUMMARY data set). 

e Verify that the entries required for the job are on the VIT. (All occurrences of VIT entries are 
listed at the bottom of the SUMMARY data set.) 

— Storage analysis requires the SMS VIT entries. 
— RU counting requires the PIU VIT entries. 
— VIT extraction origin and destination options work only on PIU VIT entries. 

e Check to see if the VIT is a different level from the VIT analysis tool. For example, the 
DISP entry is now called DSP. Therefore, if you are extracting all occurrences of VIT option 
PSS with entry name e'DI*', no matches are found in VTAM V4R2. 

e Do not specify a start or stop time. Note that an event reported on the console can be 
several seconds off from the GTF time stamp. : 

e Use the INTERVAL option to ensure that some output is seen before the job abends or is 
cancelled. 


If the job runs but the output data sets contain data from a previous job, check the DISP param- 
eter. When DISP is NEW and the data set already exists, the batch job runs anyway and then 
deletes the new data set. A message in the JCL log indicates whether this has happened. 
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Table 5 (Page 2 of 2). VIT Analysis Tool Problems: Common Symptoms and Actions 


Symptom Action 


ABEND 80A If you are running the storage analysis function with MATCH and LENGTH ee try one or 
more of the following: 


e Increase storage on the job. | 
e Reduce storage pools to one storage type (GBLK, REQS, or VTAL). 
e Match only a few pools rather than all GBLK or all VTAL or all REQS pools. 


e Run the LENGTH option without the MATCH option, and save the output for future refer- 
ence. The LENGTH option is independent of the MATCH option, so the same LENGTH 
output is shown, regardless of whether the MATCH option is specified. 


e Remove MATCH and LENGTH options. 


e Specify a start and stop time to limit the amount of data being processed. 


Message When processing multiple tapes using the VIT analysis tools, you receive the message 
CANNOT READ CANNOT READ FILE WITH DD NAME TRACE and the return code is 10. 


FILE WITH DD 
NAME TRACE 
received 


If you are attempting to process multiple standard label (SL) tapes using the bypass label 
process (BLP), verify that the LABEL parameter on the TRACE DD statement is coded correctly. 
See Table 80 on page 1165 to determine what book describes job control language (JCL). 


In addition to the actions suggested in Table 5 on page 43, try the following 
actions to help you diagnose the problem: 


e Use the DEBUG option (add it as a keyword in the parameter data set), which 


produces large quantities of data showing what the tool is doing. Run this ona 
small portion of the trace to prevent the output from being too large to be 
useful. 


Run another tool, such as the IPCS GTFTRACE subcommand, 
(7) TRACERED, or ACF/TAP to see whether they work on this trace data set 
and to compare output such as time stamps. 


Run a short job to see what is on the tape. A simple way to run a short job is 
to run VIT extraction with an expression that is never true. Use the 
NOFORMAT option to avoid the overhead of loading the format routine. You 
can use the following parameter data set as a short job: 


Desc Tell what's in this trace data set by running without extracting 
Desc any entries. 

NOWRAP NOFORMAT 

VITEXT e'zzzz' 


This data set extracts all VIT entries with the name ZZZZ. (Presumably, no 
entries start with ZZZZ.) The SUMMARY data set shows whether the data set 
wrapped, which types of records are traced, which VIT entries and options are 
traced, and the first and last time stamps. 


Documenting an APAR for VIT Analysis Tool Problems 
lf an APAR is submitted, the following information is required: 
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e Input data 


— JCL or REXX EXEC or CLIST 

— PARM data set 

— TRACE data set 

— VIT analysis tool load module (ISTRAFT1) 
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— Format load module (AMDUSRFD) 
e Output data 


— JCL log 
— Data sets produced by the VIT analysis tool 
- SUMMARY 
- LOG 
- DETAILS 
- OUTSTAN 
- VITEXT 
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VTAM Dump Analysis Tool Problems (MVS) 


This section describes how to diagnose problems that might occur while running 
the VTAM dump analysis tools and includes the following sections: 


e “Checklist for Isolating the Problem” 
e “Documenting an APAR for Dump Analysis Tool Problems.” 


If you are having problems during installation of the tool, refer to “Installing the 
VTAM Dump Analysis Enhancements and the VIT Analysis Tool” in the VTAM 
Network Implementation Guide for additional information. 


Checklist for Isolating the Problem 


1. Determine whether the error occurred as a result of an ISPF panel or a 
module. 


ISPF handles its own error conditions and displays them directly on the panel. 
If the error message appears in your IPCS output, then it is probably issued 
from a formatted dump module. 


2. If you submit your job using JCL, verify that no JCL errors are issued. If a bad 
return code is issued, determine whether it is a result of the JCL job or a for- 
matted dump module. 


3. If you receive the message Storage access failed for xxxxxxxx, browse the 
dump to determine whether the actual location exists in the dump. Storage 
requests are usually in terms of the length of the control block. For example, if 
control block BB is X'20' bytes long, the storage service will be trying to 
retrieve X'20' bytes of data. 


4. View the output to determine whether any error messages were issued during 
execution. Messages may indicate the cause of the termination. 


If the VTAM formatted dump routine cannot access a field (either in the control 
block or in the chain of pointers to the control block), an abend will occur and a 
note of the condition is made on the dump output. 


5. Check whether the required ISPF and IPCS maintenance has been applied as 
documented in the program directory. Check whether maintenance has been 
applied to IPCS, ISPF, or VTAM. If any of these are down-level, unpredictable 
results might occur. 


6. If your ISPF prompt lists or PF keys are not working properly, refer to “Key 
Data Sets Containing Information for VTAM” in the VTAM Network Implementa- 
tion Guide to ensure that everything is installed and concatenated properly. 


Documenting an APAR for Dump Analysis Tool Problems 
If an APAR is submitted for the problem, the following information is required: 


e Dump used when error occurred 
e IPCSPRNT output dataset 


IPCSPRNT is the output dataset allocated by you to store all data generated 
during an IPCS session. See Table 80 on page 1165 to determine what book 
describes IPCSPRNT. 


e JCL if submitted through batch 
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e Maintenance levels of the following: 


— FFST 
- IPCS 
— ISPF 
— VTAM 
TSO/E REXX. 


Knowing the level of IPCS, ISPF, and VTAM can help determine whether you 
are running back-level on these products. 
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Recommended Documentation for VTAM Problems 


Symptoms are often related to a particular device, command, or update to the 
system. If you suspect this is so, you should tell the IBM Support Center of this 
relationship. The following sections describe some possible relationships and the 
kind of documentation you should have for each one. : 


APAR or PTF Number 
lf the problem appears after you apply an authorized programming analysis 
report (APAR) fix, supply the APAR number. If the fix is a PTF (program 
temporary fix), supply the PTF number. The following is the format for APAR 
numbers and PTF numbers. 


Operating 

System APAR PTF 

MVS/ESA OWnnnnn UWnnnnn 
OYnnnnn UYnnnnn 


Device Type 
lf the problem is associated with the use of a particular type of terminal or 
other hardware unit, supply that device type (Such as 3278 Model 2). If the 
problem is associated with a particular type of communication link, supply 
appropriate link characteristics, such as SDLC, BSC, SNA, or non-SNA. Also, 
identify any recent microcode activity on the control units involved. 


_ Operator Command 
lf the problem is associated with a particular VTAM operator command, 
supply the full command name (such as VARY). Also, note any command 
operand (such as INACT) or a network node type (such as CDRM) that has 
been associated with the problem. 


Terminal Action 
lf the problem is associated with a particular terminal action, such as 
IBMECHO, USS LOGON, or pressing the CLEAR key, describe the action (or 
sequence of actions). 


VTAM Application Program 
If the problem is associated with a VTAM application program that is an IBM 
licensed program (such as CICS or TSO), supply the name of the licensed 
program. 


Hardware Error Condition 
Sometimes it is immediately apparent that a problem is related to a specific 
hardware error condition. The hardware error might have been detected and 
reported in several ways: 


e By an operating system message 

By a VTAM or application program message 

By the system operator _ 

By a VTAM buffer filling up with information from one device 
Rij Through LOGREC 

(8a Through SYSREC or RMS 
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e By a terminal user (an indicator of the error status appears in the operator 
information area, at the bottom of the terminal screen). 


lf a hardware error occurred, note the failure condition that accompanied it, 
such as UNIT CHECK or TIMEOUT. 


If you think your problem is related to a hardware failure, use the following 
tools to collect information about the hardware failure: 


e SDLC link level 2 (LL2) test. For more information on the LL2 test, see 
“Modify SDLC Link Level 2 Test” on page 211. 


e NCP intensive mode error recording. For more information on intensive 
mode recording, see “Modify NCP Intensive Mode Recording” on 
page 210. See Table 80 on page 1165 to determine what NCP book 
describes intensive mode recording. 


e The NetView program, if you use it in your system 
¢ LOGREC (or similar operating system facilities). 


Note: For help with hardware problems, use the NetView program if you 
have it installed, or use the system console messages to identify the affected 
part of the network. If you need further assistance, contact your IBM branch 
office. 


Coding Change 
A problem can occur after you make coding changes to the following: 


e VTAM network definitions 

e Macro usage 

e Start options 

e User-coded exit routines 

° Job control statements 
e User applications. 


Supply information about the coding change. For example, if you change the 
PACING operand on an NCP LU definition statement, supply that information. 
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Use Table 6 to determine the type of documentation you need to either solve your 
problem or supply to the IBM Support Center. 


Note: Documentation for the NetView program is included in Table 6. 


Table 6 (Page 1 of 3). Recommended Documentation for VTAM Problems 


Documentation Description 

Ri} Alias names lf your configuration is using SNA network interconnection and you are using alias 
names, keep a list of the alias names defined to each name translation program. 

Application program log (if Some user-written operator application programs produce an application program log. 

appropriate) 

DCSS map The installation process produces a map of the VTAM Shared Segment (DCSS). 


This map has the filename of your VTAMDCSS and a filetype of MAP. It is located 
on the VTAM BUILDO PRODUCTION disk (default X'29A''). 


Exit routines Keep a list of VTAM exit routines. 
Link-edit map If a VTAM load module is involved in a problem, an XREF map of the load 


module is needed to show the location of other VTAM modules within that load 
module. To get an XREF map, use the service aid LIST (AMBLIST) with the control 
statement LISTLOAD and the parameter OUTPUT=XREF. This produces a listing 
showing the module (CSECT) names and their location within the load module. See 
Table 80 on page 1165 to determine what book describes how to use the LIST 
service aid. 


Save the VTAM LKEDIT and VSCS LKEDIT files that are produced by the instal- 
lation procedure for VTAM and VSCS. These files are on the VTAM BUILDO PRO- 
DUCTION disk (default X'29A'). | 


Most VTAM modules are link-edited into multiple CSECT phases. In some 
cases, it might be necessary to determine where within the phase a failing module is 
loaded. To do this you must have the link-edit map for the phase. Save the output 
from the following: | 


e Initial installation steps for VTAM 


e Maintain System History Program (MSHP) linkage editor. The MSHP linkage 
editor is used when maintenance is applied to the system. 


Link Pack Area (LPA) Contains names and starting addresses of modules in SYS1.LPALIB. To get an LPA 
map map, use the IBM service aid LIST (AMBLIST) with the control statement LISTLPA. | 


See Table 80 on page 1165 to determine what book describes the LIST service aid. 
When it is used with a link-edit map and a dump, an LPA map enables you to identify 
a module that is found at a specific address within the link pack area. 


LOGREC This is a data set or [JJ file that contains records of various types of system 
failures, both hardware and software. For hardware failures, LOGREC entries 
contain sense and status information about the device causing the failure. For soft- 
ware failures, LOGREC entries contain information such as the program status word 
(PSW), the abend code, the failing module name (when possible), a symptom string, 
and the general registers at the time of failure. LOGREC entries are written each 
time VTAM produces a supervisor call (SVC) dump. 


MAP command output Contains the starting and ending addresses of each partition and SVA. 


NetView hardcopy log (if Contains messages routed to the NetView program that are associated with an oper- 
using the NetView program) ator terminal. 
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Table 6 (Page 2 of 3). Recommended Documentation for VTAM Problems 


Documentation Description 
NetView file (if using the Contains session awareness data for all active sessions and session trace data for 
NetView program) sessions with a resource for which a session monitor trace has been started. 


Session awareness data includes: 


Session type 

Names of session partners 

Session activation status 

IDs of subarea physical units contained in the explicit route assigned to the 
session 

e Transmission group numbers 

e Addresses and network IDs of SSCPs that own links in the transmission groups. 


Session trace data includes: 


e Session activation parameters 
e VTAM PIU data 
e NCP data. 


Network configuration List any application programs, new devices, or new levels of the operating system 
you have added to your network. 


Save the System Modification Program (SMP) configuration data set (CDS) for VTAM 
and TSO/VTAM components. See Table 80 on page 1165 to determine what book 
describes SMP. 


Program Update Tape Supply a list of any PUTs and PTFs that have been applied to your system. Also, 
(PUT) and Program Tempo- supply a list of changes that have been applied to the hardware, such as requests for 
rary Fix (PTF) engineering activity (REAs) and engineering changes (ECs). 


lf you have identified a module as the source of the problem, supply the PTF eye- 
catcher if the module has one. (The PTF eye-catcher is the latest PTF number that 
has been applied to a module. It follows the module ID in a dump.) 


Routing data Keep a table of destination subareas, explicit route numbers, virtual route numbers, 
paths, and transmission groups as well as a table associating session types, class-of- 
service (COS) names, and COS tables. 


Symptom string Some VTAM routines provide a symptom string after a failure. After an abend, you 
will receive message IST931I, which contains the symptom string text. See VTAM 
Messages and Codes for a description of message IST9311. 


The symptom string is put in the system diagnostic work area (SDWA), 
which is printed by the Environmental Recording, Editing, and Printing (EREP) 
program as part of the LOGREC entries. See Table 80 on page 1165 to determine 
what book contains more information on LOGREC. 


If a first failure support technology (FFST) probe produced the symptom string, EPW 
messages will appear in the console listing to describe the symptom string. See 
Table 80 on page 1165 to determine what book contains more information on FFST 
messages. 


[84 The symptom string is put in the first records at the beginning of the SVC 
dump, usually on the first page. 


SYSREC The VSE recorder file (SYSREC) contains error records for devices owned by VTAM. 
SYSREC records are printed with the EREP program. 
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Table 6 (Page 3 of 3). Recommended Documentation for VTAM Problems 


Documentation 


System-console hardcopy 
Log 


Tables 


Version/Release number 
Component ID 


VTAM definition library 
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Description 


Shows all messages sent to or commands received from the operator. May help 
indicate when the system began to have problems. (VTAM problems may not be 
apparent at the time they occur.) 


If your installation has written its own version of a VTAM message, supply the original 
VTAM message when you report the problem. 


Keep a list of the VTAM tables your installation has defined, such as USS and 
logmode. 


V4R2 

Component ID 

VTAM 5695-11701-201 
VTAM 5654-01001-420 
VTAM 5686-06501-FE6 


At VTAM startup when VTAM initialization is completed, messages ISTO20I and 
IST13491 are issued with this information. Message ISTO20! displays the version and 
release number, and message IST1349i displays the component ID. 


In addition, information about the release level of each component is contained in an 
access-method-support vector list pointed to by the access method control block 
(ACB). See “ACB-Create an Access Method Control Block” in VTAM Programming 
for more information about the ACB. 


This is a set of definition statements for resources in the VTAM network, such as the 
application programs and network nodes. The VTAM definition library also contains 
the start options used to initialize VTAM, unless they were entered by the system 
operator. Include configuration lists and user installation exits with the definition 
library. Detailed information about the VTAM definition library is in the “Key Data 
Sets Containing Information for VTAM” in the VTAM Network Implementation Guide. 
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Submitting Problem Documentation 


lf after talking to the Level 2 Support Center representative about your problem, it is 
decided an APAR should be submitted to the VTAM change team, it may be more 
convenient for you or the VTAM change team to have the documentation submitted 
in machine-readable form (that is, on tape). Machine-readable documentation can 
be handled most efficiently by the change team if you follow these guidelines when 
creating the tape. 


Tapes that are submitted to the VTAM change team may be standard label (SL) or 
non-label (NL). Cartridge (3480) improved data capability (feature on 3480, 
standard 3490) (IDRC) may be used. Each tape should contain an external label to 
identify the tape and its contents in some way. The APAR number should appear 
on the label. If you use multiple tapes or multiple files on one tape include a sepa- 
rate explanation itemizing the contents of each tape. 


With each tape, include the output from the job used to create the tape. To verify 
that the tape was created correctly and that the job completed normally, the change 
team must have the output from the job that created the tape (not simply the job 
control statements that were used). 


Submitting Documentation (MVS) 
Note: The information in this section is from APAR OY17061. See that APAR for 
additional information. 


To submit dumps, traces, and other information to the MVS change team, do the 
following: 


For dumps 
You should not dump data in any way prior to or during the transfer of the 
dump to tape. MVS/ESA dumps can be transferred to tape using IPCS or 
IEBGENER. See Table 80 on page 1165 to determine what book describes 
how to use the IPCS and IEBGENER utilities. 


You should not change the data control block (DCB) parameters of the dump 
data set. The DCB parameters should be defined for MVS/ESA as follows: 


LRECL=4160, BLKSIZE=4160, RECFM=F 


For GTF traces 
Move the GTF trace data from the trace data set (which is usually 
SYS1.TRACE) to tape using IEBGENER only. The DCB parameters for a 
GTF trace should be one of the following: 


LRECL=4092, BLKSIZE=4096, RECFM=VBA 
LRECL=4092, BLKSIZE=32760, RECFM=VBA 


For both traces and dumps, do not reblock the data (that is, use a different 
BLKSIZE) when moving it to tape. Use only the DCB parameters shown in 
the preceding example. 


Restriction Use of any other utility (IBM or non-IBM) to transfer dump 

| or trace data to tape may result in a processing delay and 
could result in the APAR being returned to you (closed 
“RET”) due to the inability of the change team to process 
the tape. 
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For Other Types of Information 
Other types of information (for example, VTAM definitions, NCP stage one 
input, and console logs) may be submitted on paper or tape. If you submit the 
data on tape, it should be written to tape using IEBGENER only. The DCB 
parameters used when writing this type of data to tape should be the same as 
the input data set (that is, the same DCB parameters as the source of the 
data). 


Submitting Documentation (VM) 
To submit dumps, traces, and other information to the VM change team, do the 
following: 


For Dumps and Traces: 
e Make sure you have accessed the DVF and TRACERED disks. 
e Process the dump using DUMPLOAD. 
Process the trace using TRACERED. 
e Receive the trace to a disk. 


¢ Use VMFPLC2 to create the tape. See Table 80 on page 1165 to determine 
what book describes VMFPLC2 for your operating system. 


e Include on the tape all the files produced by the processing of the dump (for 
example, DUMP, REPORT) or the trace and other files that have been 
requested by Level 2. 


If you have a problem processing either the dump or trace, you should submit 
unformatted system dump files to the VTAM change team. Both the dump and 
the trace are initially in this VM system dump type format (VM CP QUERY RDR 
shows class DMP, QUERY TRFILES shows trace files). The only way to put these 
files on tape is to use the CP SPTAPE command. See Table 80 on 

page 1165 to determine what book describes how to use SPTAPE on your 
operating system. If the dump or trace can be processed satisfactorily, do not 
use this format because it makes the tape more difficult to process for the 
change team. 


For Other Types of Information: Following are examples of other files you may 
need to submit: 


e VTAM and system console logs 

e Nucleus, load, and LKEDIT maps 

¢ VTAMLST files (for example, major node definitions, start lists) 
e DTIUSERx assemble files 

e VTAM or VSCS LOADLIBs. 


After dumping all the files to the tape, write 100 tape marks at the end as follows: 
VMFPLC2 WIM 100 

Adding the tape marks ensures that the tape does not spin off the end. 

If you need to submit both system dump files and CMS files, you can put SPTAPE 
and VMFPLC2 output on the same tape. You can use the class B CP command © 


DETACH raddr FROM userid LEAVE to leave the tape positioned for SPTAPE after 
using VMFPLC2, or you can use VMFPLC2 FSF x to forward space “x” tape marks to 
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bypass the SPTAPE files. Include a cover letter with the tape indicating what com- 
mands were used to process the tape and what files are on the tape. 


Submitting Documentation (VSE) 
Note: The information in this section is from information APAR 1107725. See that 
APAR for additional information. 


Dump Output 


Attention Routine (AR) Dump: To send an attention routine dump to tape, issue 
DUMP Fx,cuu 


where cuu is the address of the tape drive. 


SYSDUMP: Using INFO/ANALYSIS: 


e Select DUMP OFFLOAD to put a dump file residing in the dump library onto 
tape. 


e Select DUMP ONLOAD to copy a dump file from tape into the dump library. 


Stand-alone Dump: The output tape from the stand-alone dump can be submitted 
as is. , | 


Power Queue Output 
Use Power Offload (POFFLOAD) to put Power queue entries onto tape. 


BACKUP or SAVE Puts queue entries onto tape. 
LOAD Retrieves queue contents from tape. 
SELECT Retrieves individual queue entries. 


TPRINT Output: Use Power Offload (POFFLOAD) to put TPRINT output onto 
tape. 


DOSVSDMP Output: Use Power Offload (POFFLOAD) to put DOSVSDMP output 
onto tape. 
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Chapter 2. Collecting Documentation for Specific Types of 
Problems 


After you have classified your problem as a specific type using information in 
Chapter 1, “Diagnosing VTAM Problems: Where to Begin” on page 3, this chapter 
shows you how to collect the additional information you need before contacting the 
IBM Support Center. 


This chapter includes the following sections: 


e “Common Problem Determination Procedures” describes procedures for specific 
problem types. 


e “Failing Module” on page 109 tells what to do when you have isolated the 
problem to a specific module of the VTAM program. You might be sent to this 
section from within the procedure for the problem type you have chosen. 


e “Symptom String Structure” on page 111 describes the meaning of the fields 
found in a symptom string. 


e “Reporting the Problem to IBM” on page 112 describes how to report the 
problem to your local branch office or the IBM Support Center. 


Common Problem Determination Procedures 
This section includes a description of the following procedures: 


e “Abnormal End (Abend) (MVS) (VM)” on page 58 
e “Program Check (VSE)” on page 63 
e “Wait” on page 67 

— “VTAM Locks’ on page 80 

— “Using the VARY INACT,FORCE Command” on page 83 
“Loop” on page 86 
“Message Problem” on page 93 
“Incorrect Output” on page 96 
“Performance Problem” on page 101 
“Storage Problem Procedure (MVS)” on page 105 
“Documentation Problem” on page 108. 
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If the problem is an abend, use the procedure in Figure 2 to collect the following 


4a 


4b 


4c 


4d 


4e 


Get dump 
output 


Find symptom 
string 


Find ABEND 
code 


Find the 
PSW 


Find the 
failing address 
and the 
failing instruction 


Find the 
module ID 


Find the 
general registers 


Determine which 
register has 
invalid information 


documentation: 


e Dump output 
e LOGREC 
e Symptom string 


e Abend or system completion code 
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e Contents of the general registers (at the time of the abend) 
e Module ID and PTF eye-catcher 
e PSW (at the time of the abend) 
e VIT at the time of the abend. 


Chapter 3 


Look in 
Messages 
and Codes 


Find the address 
of abend issuer 


Find the 
module ID 


Figure 2. Overview of the Abend Procedure 
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Abend 
80A, 40D, 
202 


Get dump 
output, LOGREC, 
VIT output 


Look in 
System Codes 
manual 


Report or go to 
Failing Module 
procedure 
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Following is a description of each step shown in Figure 2 on page 58. 
1. Get dump output. 


VTAM usually produces a dump for an abend. If no dump was taken, the 
dump files or spools might be full. Check for a message that an error occurred 
while VTAM was trying to produce the dump. If VTAM is not able to complete 
the dump, you have to re-create the abend or wait for it to occur again. 


Note: To extract abend information from a VTAM dump, invoke the CLIST 
“ISTVABND” on page 280 or continue with the following steps. 


2. Find the symptom string. 


A symptom string is a structured database search argument. The symptom 
string gives information about what was happening at the time of the abend. 
Message IST931I, which contains the symptom string text, is issued when a 
symptom string is produced. A record is written to the LOGREC data set 
whenever VTAM takes a supervisor call (SVC) dump. For about 85% of all 
abends, recovery routines produce a symptom string subset, which you can get 
by printing LOGREC. The symptom string subset, if it occurs, is located in 
control block SDWA in LOGREC. 


The SDWA address should be listed in the beginning of the dump, in the 
dump abstract information. It is also printed out in LOGREC, labeled “Hex 
Dump of Record” at the end of each software entry. 


The symptom string begins at X'194' in the SDWA. Field SDWAURAL gives 
the length of the symptom string, which can be up to 256 bytes. 


Wi} There are three ways to find the symptom string: 


a. If VIT is active, locate the ABND SNAP trace record. This shows the 
address of the SDWA. . 


b. If VIT is not active, scan the registers shown at the beginning of a dump for 
the address of the SDWA. 


The SDWA can be difficult to recognize. However, the abend code is at + 
X'4', so knowing the abend code before you start looking for the SDWA 
can help. 


c. If neither the trace nor the dump is available, scan the software error 
portion of LOGREC for the symptom string. The symptom string can be 
found in the comments section to the right of the SDWA. 


See “Symptom String Structure” on page 111 for a description of the fields in a 
symptom string. 


3. Find the abend, system completion, or user completion code. 


You can find the abend (or completion) code in the output of several dif- 
ferent service aids. The system control block RTM2 work area (RTM2WA), the 
SYS1.LOGREC software record, and the task control block (field TCBCMPC) 
contain the completion code. The RTM2WA is pointed to by the TCB of the 
failing task (field TCBRTWA), and is listed after the abending TCB. 


Ra You can find the abend code, ABNCODE, in the abend work area, 
ABNWA. Low core X'298' points to the ABNWA. You can also find registers 
0-F and the PSW in the ABNWA. Registers 0-F are found at offset X'00' of 
the ABNWA, the PSW is found at offset X'40', and the ABNCODE is found at 
offset X'48'. 
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For more information on the abend codes issued by VTAM, see Chapter 11, 
“Abend Codes (MVS) (VM)” in VITAM Messages and Codes. 


. Determine whether the abend code is OCx. 


If the completion code is of the form OCx (where x = the program interruption | 
code from the PSW), continue with this step. If the abend code is not OCx, go 
to step 5 on page 61. 


a. Find the program status word (PSW) at the time of the abend. 
The PSW is found in: 


e [XS] The LOGREC output, the SDWA, or the RTM2WA 
e [J The ABNWA, the SDWA, or the LOGREC output. 


The location of the PSW in the dump output varies depending on the type 
of dump taken. For assistance in locating the PSW in dump output, see 
the diagnostic books for your operating system. 


b. Find the failing address or the failing instruction. 


The PSW contains either the address of the next instruction to be executed 
at the time of the abend or the instruction that failed at the time of the 
abend, depending on the interruption code. 


If the interruption code is X'10' or X'11', then the PSW address points to 
the failing instruction. Otherwise, back up the PSW by the instruction 
length, and that is the failing instruction. Scan the dump output to find the 
address given in the PSW. 


Note: If VTAM is using an extended-mode PSW, you must determine 
if the PSW address is 24 or 31 bits in length. If the PSW is 24 bits in 
length, ignore the high-order byte. 


If you cannot find the address, the dump might not contain the relevant 
portion of main storage. 


c. Find the module ID for the module that contains the failing address. 


VTAM identifies modules with the module name, Julian date, and PTF or 
APAR eye-catcher at or near the beginning of each module. This module 
identifier is in the form: 


ISTxxxxx yy.ddd nnnnnnn 


where xxxxx is the last five characters of the module name, yy.ddd is the 
Julian date the module was assembled, and nnnnnnn is the latest PTF or 
APAR fix (if any) that has been applied to this module. 


Wii VSCS identifies modules with the module name, Julian date, and PTF 
or APAR eye-catcher at or near the beginning of each module. This 
module identifier is in the form: 


DTIxxxxx yy.ddd nnnnnnn 


where xxxxx is the last five characters of the module name, yy.dad is the 
Julian date the module was assembled, and nnnnnnn is the latest PTF or 
APAR fix (if any) that has been applied to this module. 


Sometimes VTAM puts the module name of the failing module in LOGREC. 
If it is not there, you can find it in a dump. To find the module ID in a 
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dump, start at the failing address and scan in descending address order 
along the right side of the listing. The module ID is printed in EBCDIC. 


You can also scan the LPA map for the name of the load module and 


then go to the AMB list in the load module to find the CSECT that contains 
the failing address. 


if the failure is in a shared VTAM module, you can scan the VTAM 


DCSS MAP file for the name of the module that contains the failing 
address. 


. Find the general registers. 


¢ [SJ The LOGREC output, the SDWA, or the RTM2WA 
¢ [Qj The ABNWA, the SDWA, or the LOGREC output. 


_ Use the diagnostic books for your operating system to help find the regis- 
ters. 


. Determine which register has information that is not valid. 


The failing instruction often uses a register with an address that is not valid 


in one of the general registers, or points to an location that is not valid (for 
example, low-address storage). Use Principles of Operation for your oper- 
ating system, the program interruption code from the SDWA or from 
fi] ABNWA and the general registers used in the failing instruction, to 
determine (if possible) which register contains or points to incorrect data. 


Note: When determining the validity of the register's contents, be careful 
to consider the address mode used by your operating system. Depending 
on the address mode being used, values used in 31-bit addressing might 

be interpreted differently than those used in 24-bit addressing. 


Next go to step 9 on page 62. 


5. Determine whether the abend code is 0AB, OAC, OAD, or 15D. 


These abend codes indicate a TSO/VTAM abend. For diagnosis information, 
go to “TSO/VTAM Abends” on page 117. 


6. Determine whether the abend code is OAx. 


If the abend code is in the form OAx, continue with this step. If not, go to step 
7 on page 62. 


a. Find the abend code explanation in Chapter 11, “Abend Codes (MVS) 


(VM)” in VTAM Messages and Codes. 


An abend code of OAx indicates a problem within the VTAM network. The 
problem could have originated in VTAM, the NCP, an application program, 
or the hardware of some other network component. Look up the code in 
Chapter 11, “Abend Codes (MVS) (VM)” VTAM Messages and Codes. 
Most OAx abends place a return or reason code in register 15 at the time of 
failure. You can find the return code in register 15 by using the set of 
general registers from: 


e [SJ The LOGREC output, the SDWA, or the RTM2WA 
¢ [J The ABNWA, the SDWA, or the LOGREC output. 


. Find the address of the module that issued the abend, using the PSW, 


which points to the next instruction after SVC 13. 
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c. Find the module ID. — 


From the address determined in the previous step, scan in descending 
address order through the dump to find the module ID (see step 4c on 
page 60). : 


Go to step 9. 
7. Determine whether the abend code is 80A, 40D, or 202 


If the abend code is one of these, continue with this step. Otherwise, continue 
with step 8. 


These abend codes indicate storage problems. Collect the following documen- 
tation: 


e A dump of the VTAM address space 

e A dump of the VTAM common storage area (CSA) 
e LOGREC output 

e VIT output at the time of the abend. 


After obtaining this documentation, go to “Reporting the Problem to IBM” on 
page 112. 


8. If the abend code is none of the above, refer to your operating system 
documentation. 


To determine the publication that describes the abend codes for your operating — 
system, see Table 80 on page 1165. 


Each code has an explanation of the documentation required and the problem 
determination steps to follow. For example, many abends occur during exe- 
cution of SVC instructions. Parameter lists and register contents passed to 
SVC routines are in the diagnostic books for your operating system. These 
books might suggest that you obtain additional information such as a module 
name, a return code, a register containing information that is not valid, or the 
name of a system control block containing parameters that are not valid. After 
making a complete check of these sources, you are ready to report the 
problem. 


9. Report or go to the failing module procedure. 


lf you determined the module ID, go to “Failing Module” on page 109. Other- 
wise, see “Reporting the Problem to IBM” on page 112. 
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Program Check (VSE) 


If the problem is a program check, use the procedure in Figure 3 to collect the 
following documentation: 


e Dump of VTAM partition, supervisor, and data spaces. 

e SYSREC 

e Symptom string 

e Message information 

e Contents of the general registers (at the time of the error) 
e Module ID and PTF eye-catcher 

e PSW (at the time of the error). 


Program Check 


Get dump 
output 


Find symptom 
string 


Find point 
of failure 


Check VSE 
supervisor 


Determine 
bad register 


Identify 
failing module 


Report or go 
to Failing 
Module procedure 


Figure 3. Overview of the Program Check Procedure 


Following is a description of each step shown in Figure 3. 
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1. Get dump output. 


When a VTAM abend occurs, two back-to-back dumps (IDUMPs) and a dump 
for each open data space are taken. The first dump contains the VTAM parti- 
tion and VSE supervisor storage, including used portions of the system 
GETVIS area. The second dump contains the shared virtual area (SVA). Both 
dumps are necessary because the SVA contains initialization and user-task 
modules that are not automatically dumped by the supervisor. The dumps 
contain the same symptom string data. 


The VTAM job should specify: 
// OPTION DUMP,SYSDUMP 


OPTION DUMP provides the system GETVIS area and other supervisor areas 
as part of the VTAM abend partition dump. Do not specify PARTDUMP; 
OPTION PARTDUMP does not provide all of the VSE supervisor areas used in 
performing VTAM functions. 


In the hard wait cases, use the formatting option to print the VSE supervisor 
areas and the VTAM partition. If VTAM resides in a private partition, print the 
SVA. If VTAM does not reside in a private partition, it is not necessary to print 
the SVA since VTAM modules are not executed in the SVA. 


See Table 80 on page 1165 to determine what book describes how to obtain 
and format VSE dumps. 


. Find the symptom string. 


A symptom string is a structured database search argument. The symptom 
string gives information about what is happening at the time of the program 
check. A record is written to the SYSREC file whenever VTAM takes an SVC 
dump. For about 85% of all program checks, recovery routines produce a 
symptom string subset, which you can get by printing SYSREC. 


Recovery routines produce the symptom string if storage is available for it. The 
symptom string subset, if it occurs, is located in the first records of the SVC 
dump output, usually on the first page. Figure 17 on page 111 shows an 
example of a symptom string subset in dump output. 


3. Locate the point of failure. 


e lf the program check is reported by VSE message 0SO3l, the exception 
type and location are contained in the message text. 


e For hard wait states (X'FFF' and X'FFB'), the failing instruction address 
can be determined from the program check old PSW. See Table 80 on 
page 1165 to determine what book describes the contents of the 
DOSVSDMP dump. 


e For task termination messages other than VSE message OSO3l, find the 
save area containing the error PSW and registers (in the beginning of the 
task termination dump). | 


e For message IST252I with return code 36, or VSE message OVO8I, the 
canceled task is VTAMRP, but the save area used is not the normal 
subtask save area. Instead, the VSE program check handler stores the 
PSW and registers at label SVPCSAVE. 


¢ For message IST252! with return code 20, the VSE dump of VTAM is taken 
under the main task. Locate the VITAMRP Save area either by finding its 
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task control block in the VSE supervisor dump or by using location X'408' 
to find the ATCVT and field ATCFLDA to locate module ISTINCFO. 
ISTINCFO contains the save area. 


Identify the save area by the name VTAMRP in the first 8 bytes. VTAMRP 
begins the save area of the routine that generated the dump. The PSW 
and registers of the failing task start at offset X'90' from the beginning of 
the save area. 


Note: The registers of the failing task begin with register 9 and end with 
register 8, as follows: 


R9, R10, ... R15, RO, R1, ... R8& 


For wait state X'FED', use the address in register 5 as the failure address. 


4. For WAITFFF and WAITFFB, determine if the failure is in the VSE super- 
visor. 


Check the VSE supervisor listing, and include the label preceding the point 
of error in your information for the Support Center. If the logic pertains to a 
VTAM function, the problem might be in VTAM. 


If the instructions have been overlaid by data, try to identify that data from 
its contents, and note where the overlay begins and its length. If the 
overlay contains terminal data or a recognizable VTAM control block, the 
problem is probably in VTAM. Save any pertinent information about the 
overlay to discuss with the IBM Support Center. If the overlay is deter- 
mined to be a VTAM control block, the name should be given to the 
Support Center. 


If the last interruption is a VTAM SVC 49 or SVC 53, add that to the infor- 
mation in the form SVCxx. 


If the last interruption is another VSE SVC issued by VTAM, then VTAM 
might be issuing the SVC incorrectly. Add that information in the form 
SVCxx. 


Proceed to step 5, using the address in the SVC old PSW as the failure 
address. 


If the last interruption is an I/O interruption from a VTAM-owned channel- 
attached device, the problem might involve one of the VTAM appendage 
routines. 


For the FFB condition, try to determine what is being referred to that 
caused the page fault. If the exception address at location X'90' points to 
an area in the VTAM partition, the problem might be in VTAM. If the 
address is within a VTAM module (appears to be executable code), identify 
the module as in step 6 on page 66. If not, try to identify it as a VTAM 
control block, using the list of control block IDs in Appendix H, “Storage 
and Control Block ID Codes” on page 1137. If you determine the name of 
the control block, add the name to your list of documentation. If not, the 
area should be either in a VTAM module (See step 6 on page 66) orina 
VTAM buffer poo! (see Appendix B, “Finding VTAM Buffer Pools (VM, 
VSE)’). 


5. Determine which register contains or points to incorrect data. 
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The failing instruction normally has an address that is not valid in one of the 
general registers or points to a location that is not valid (for example, low 
storage). Use Principles of Operation for your processor, the program inter- 
ruption code from the PSW, and general registers in the failing instruction to 
determine (if possible) which register contains or points to incorrect data. Add 
this register number string in the form REGnn to the information for the Support 
Center. 


6. If the failing instruction address found in step 3 on page 64 is in the 
VTAM partition, identify the failing VTAM module. 


Most VTAM modules are identified by a field containing the name IST xxxxx and 
the current level of the module near the beginning of the module (for example, 
ISTTSCBY 93.299 UD48890). To locate this identifier, scan the dump in 
descending address order from the point of failure. The identifier is printed in 
EBCDIC along the right-hand side of the dump. Add the module name to your 
documentation list. Go to “Failing Module” on page 109 to continue obtaining 
information for the Support Center. 


7. Report or go to the failing module procedure. 


If you determined the module ID, go to “Failing Module” on page 109. Other- 
wise, go to “Reporting the Problem to IBM” on page 112 for information on 
contacting IBM. 
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Wait 
If the problem is a wait, use the procedure in Figure 4 on page 68 to collect the 
following documentation: 


I/O trace output 

Buffer contents trace output 

Session trace data (if using the NetView program) 

Session awareness data (if using the NetView program) 

Dump of the VTAM primary address space including CSA 

Dump of the VTAM virtual machine including DCSS. (DCSS is called DSS 
in VM commands.) 

° Dump of the VTAM partition and VSE supervisor. 

e List of: 

— Waiting process anchor blocks (PABs) 

— Waiting request elements (WREs) and associated event IDs (EIDs) 
— Waiting request parameter headers (RPHs). 


e For problems associated with an application program: 
— Output from the VIT (all options except LOCK) 
— RPLs or FMCBs queued to the ACDEB. 


e¢ For problems associated with the network: 
— Trace output 
- Line trace 
- Generalized PIU trace (GPT) 
- Transmission group (TG) trace 
- Scanner interface trace (SIT) for IBM 3720, 3725, and 3745 controllers. 
- Dynamic trace of the integrated communication adapter (ICA) (if 
available) 
— Dump output 
- NCP dump 
- MOSS dump 
- CSP dump 
— Reports from NetView, IMR, or EREP (if available). 


Note: Use the documentation you have available to isolate or resolve the problem. 
If you have to re-create the problem, make sure the traces listed above are active. 
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Determine 
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e Note any message on system 
or NetView log. 
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Figure 4. Overview of the Wait Procedure 
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Following is a description of each step shown in Figure 4 on page 68. 


1. Determine the extent of the wait condition. 


Determine how extensive the wait state is in the operation of the VTAM 
network. Determine whether all VTAM processing stopped or only processing 
with respect to a single device, application, or something in between. Also 
determine what, if any, recovery action was taken at the time the wait was 
encountered by the operator or user. Some information about the activity that 
immediately preceded the wait might be available on the system log or in appli- 
cation program transaction logs. 


2. Did a log on, log off, or command fail to complete? 


If so, continue with this step; otherwise, go to step 3 on page 70. 


If the wait condition was actually the failure of a VTAM procedure to com- 
plete, use the DISPLAY ID command to identify the status of VTAM 
resources at the time of the problem. Note any status codes that are 
abnormal. (Resource status codes are explained in “Resource Status 
Codes and Modifiers” in VTAM Messages and Codes.) 


Use the VTAM DISPLAY PENDING, DISPLAY SESSIONS, or MODIFY 
lOPD commands to identify I/O requests for which VTAM is awaiting a 
response from a network node. Sometimes a network node appears in a 


- pending state awaiting the completion of activity at a higher- or lower-level 


node (for example, PSUB1, PTRM2). The pending status on the other 
node is needed in such a case. See “Resource Status Codes and 
Modifiers” in VTAM Messages and Codes for information on resource 
status codes. 


Use the VTAM DISPLAY BFRUSE command to get information about 
VTAM buffer pools. Save the output for use later in this procedure. 


A VTAM operator might have attempted a recovery action (such as issuing 
a VARY INACT,FORCE command). “Using the VARY INACT,FORCE 
Command” on page 83 shows how to determine whether this command 
completed. Check the node status to determine if the recovery action reset 
the state of the node for which the original command was issued. 


If VTAM is waiting for an I/O response, look at the output of the VTAM 
buffer contents trace (assuming it is active when the problem occurs). If 
the trace shows that VTAM did send a request and is expecting a 
response, the problem is probably in another network node. 


You can get additional information on the status of a command from the 
VTAM internal trace (VIT). With the SSCP and PIU options, you can match 
requests and responses and determine any requests that are outstanding 
(that is, for which responses have not been received). The SMS option 
supplies information about resource usage, and the PSS option provides 
information about VTAM's scheduling of the dispatching process. (See 
Chapter 9, “Using the VTAM Internal Trace (VIT)” for a description of the 
internal trace entries.) 


At this point you might have enough documentation to report the problem to the 
Support Center. If so, go to “Reporting the Problem to IBM” on page 112. 
Otherwise, go to step 5 on page 72. 
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3. Is network traffic stopped through a specific node? 
If so, continue with this step. Otherwise, go to step 4. 


e Add the specific node type to your problem documentation. For example, 
the node could be a 3705, 3720, 3725, 3745, 3790, or a 3274. NetView 
and EREP facilities show whether errors have been recorded for the node 
in question. Session trace data (collected by the NetView program) shows 
whether the node is not responding to VTAM, or whether VTAM is dis- 
carding the responses. Consider using NCP intensive mode recording 
(IMR) for recurrent problems of this type. 


e Note any messages on the system or NetView command facility log 
reporting ER-INOP outages or other failures. Use the VIT trace, or use the 
I/O trace with the EVERY operand, to trace the network flow up to the point 
of failure. NetView, LOGREC, and SYSREC show the 
reason for the INOP. 


e For NCP-related problems, use the line trace or generalized PIU trace if the 
affected node is in an adjacent subarea. Use the transmission group trace 
to record intermediate node flows up to the point where the problem 
occurred. 


e If the problem might be in NCP software or communication controller hard- 
ware, obtain a dump of NCP storage. If the wait affects only part of the 
network, use the dynamic NCP dump facility. It allows the rest of the 
network to continue operating while the dump is taken. If the failure 
requires reactivating the NCP, use the MODIFY DUMP command. See 
“Network Control Program (NCP) Dump” on page 227 for more information 
on NCP dumps. 


If the NCP is hung or if the hung resource is attached to an NCP, see 
Table 80 on page 1165 to determine what NCP diagnostic book describes 
troubleshooting the NCP. 


° If the problem is in a device attached to the ICA, use the dynamic 
trace of the ICA to obtain information about line-related errors. See 
Table 80 on page 1165 to determine what book describes the dynamic 
trace. 


e If the problem is in a channel-attached device or a channel-to-channel 
attachment, examine one of the following traces, if available, to determine 
the sequence of events preceding the wait. (If no trace output is available, 
you have to re-create the problem to get it.) 


— VIT trace with the CIO option 

CCWTRACE 

(7) CP virtual machine trace with I/O, SIO, CCW, and CSW. 

SDAID program with the SIO and I/O trace types and the output 
of CCWD. To see all the data that is transferred on the channel, set 
the value of CCWD equal to IOBUF size. 


To determine what book describes I/O control blocks for your operating 
system, see Table 80 on page 1165. 


lf enough information is available, go to “Reporting the Problem to IBM” on 
page 112. Otherwise, go to step 5 on page 72. 


4. Is it a session or application program wait? 
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If the wait condition appears to be related to a particular VTAM application 
program, continue with this step. Otherwise, go to step 5 on page 72. 


e Enter the DISPLAY ID command for the application program, using the 
EVERY or SCOPE=ALL operand. If there are any nodes with status 
ACT/U, re-enter the DISPLAY command. If you are again informed that the 
status of a node is ACT/U, issue VARY INACT,FORCE for that node. If 
you still have a wait condition, continue with the next step. 


e If only one application program is waiting while others continue to commu- 
nicate with VTAM, that application program probably contains an error. To 
determine what caused the problem, obtain a dump of the application 
program and the operating system supervisor at the time of the problem. 


— Make sure that the error is not an operating system error. (Use the 
diagnostic boaks for your operating system.) 


— If possible, use the dump to determine the reason the application 
program is waiting. If the application program is not waiting for VTAM, 
use the documentation for the application program to determine the 
reason for the wait. If the problem is in TSO/VTAM, go to Chapter 3, 
“Collecting Documentation for TSO/VTAM Problems (MVS).” If the 
problem is in VSCS, go to Chapter 4, “Collecting Documentation for 
VSCS Problems (VM).” 


e If VTAM still seems to be the cause of the problem, you need output from 
the VIT to obtain a record of activity on the failing session. Because large 
amounts of data will wraparound in the internal trace table, you might want 
to specify MODE=EXT. 


See Chapter 9, “Using the VTAM Internal Trace (VIT)” for more information 
on using the internal trace. You can also use the I/O or buffer contents 
traces to get information about all sessions with that application; specify 
ID=application program name. 


e Using a dump of the problem, find the address of the VTAM ACDEB for the 
application program. 


You can find an ACDEB associated with an application by using the 
VTAMMAP SES formatted dump tool. If VTAMMAP cannot be run, 
then find the ACDEB chain pointer in the ATCACDA field of the ATCVT. 


a. Use the ACDEB's address to find it in the dump. 


On the FMCB RECEIVE ANY queue, ACDRAFQH points to the first 
FMCB. 


On the RPL RECEIVE ANY queue, ACDRARQ points to the first RPL. 
Notes: 


1) If there are FMCBs (ACDRAFQH is not equal to 0), but no RPLs 
(ACDRARQ = 0), a problem has prevented the application program 
from issuing RECEIVEs. 


2) If there are RPLs (ACDRARQ is not equal to 0), but no FMCBs 
(ACDRAFQH = 0), there might be a problem involving the continue 
any/continue specific (CA/CS) state of the session. (See 
“Continue-Any Mode Versus Continue-Specific Mode” in VTAM Pro- 
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gramming for more information on the continue any/continue spe- 
cific mode.) 


b. Check for blocked PABs in the process scheduling table (PST). 


—h 


ACDTSKID points to the PST. 


Look at the following PABs in the PST. To determine the offset | 
locations for these PABs, see VTAM Data Areas for MVS/ESA, VTAM 
Data Areas for VM/ESA, or VTAM Data Areas for VSE/ESA. 


PSTRQPAB Request PAB 
PSTRSPAB Response PAB 
PSTUEPAB User exit PAB 


See steps 6 and 9 for additional recommended actions. | 


. Get the LUCB address (field ACDLUCBA in the ACDEB). 
. Get the address of a chain of FMCB extensions (field LUCFMCBA in 


the LUCB). Each FMCB extension represents one LU-LU session. 


. Each FMCB extension contains a pointer (field TSPFMCBA) to the 


address of an associated FMCB. Find the FMCBs associated with 
hung sessions. 


In those FMCBs, look for: 
— The CA/CS indicator (in TSPPSFL1 and TSPPSFL2) 


— The data queues (in TSPACCUM, TSPEWAIT, TSPNWAIT, 
TSPEDATA, TSPNDATA, TSPTSOP, and TSPTSIP) 


— Session state flags (in TSPSESSR, TSPDTSR, TSPCRVSR, and 
TSPRQRSR). 


. Determine whether there are any indications of unusual conditions. 


See VTAM Data Areas for MVS/ESA, VTAM Data Areas for VM/ESA, 
or VIAM Data Areas for VSE/ESA. 


. Make a cross-reference listing of network addresses and node names 


to correlate the VIT PIU and 1/O trace entries with VTAM session 
control blocks, such as the LUCB and FMCB. 


See Table 80 on page 1165 to determine what NCP book contains infor- 
mation on hung sessions. 


If enough information is available, go to “Reporting the Problem to IBM” on 
page 112. Otherwise, go to step 5. 


5. Dump and examine the system data areas. 


If you have not already done so, obtain a dump of the VTAM address 
space, CSA, LSQA, and SQA. 


Find and analyze the task control blocks. Use the VTAMMAP PABSCAN dump 
tool to format the output. See “PABSCAN” on page 295 for information on 
using PABSCAN. See Table 80 on page 1165 to determine what book con- 
tains more information on using dumps and finding and analyzing task control 
blocks. 


If you have not already done so, issue #CP VMDUMP 0- DSS FORMAT 
GCS, with the appropriate options, to obtain a dump of the VTAM virtual 
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machine. Send the dump output to an authorized service machine to obtain all 


of the output. 


If you have not already done so, obtain a dump of the VTAM partition, 
SVA, and VSE supervisor. Find and analyze the task control blocks. See 
Table 80 on page 1165 to determine what book contains information on 
locating and analyzing task contro! blocks. 


6. Check for waiting PABs. 


Note: You can use the VTAMMAP VTCVTPAB formatted dump tool as 
an alternative to step 6. 


Look at the following PABs in the ATCVT. To determine the offset locations for 
these PABS, see VTAM Data Areas for MVS/ESA, VTAM Data Areas for 
VM/ESA, or VTAM Data Areas for VSE/ESA. 


ATCCSPAB 
ATCVDPAB 
ATCPXPAB 
ATCPUPAB 
ATCPUIOP 

ATCLUSRT 
ATCNSPAB 
ATCNOSPB 
ATCSSPAB 
ATCSOPAB 
ATCCNSPB 
ATCTPMPB 
ATCTRMPB 


Configuration services PAB 

VARY definition DYPAB 

Buffer pool expansion DYPAB 
Physical unit services DYPAB 
Physical unit services I/O DYPAB 
Logical unit services router DYPAB 
TSC no sessions DYPAB 


-Network operator services DYPAB 


Session serialization PAB 
Session outage notification PAB 


| R70] CNS logon PAB 


Message DYPAB 
Termination subtask DYPAB. 
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Check the contents of the PABWEQP (or the PABVERYA for very extended 
PABs) and PABRPHA fields. The field PABWEQP in each PAB contains the 
address of a chain of work elements that have not yet been processed by | 
VTAM. The field PABVERYA is defined at the same location as PABWEQA 
and contains a pointer to an array of WKE queues. 


The array pointed to by the PABVERYA field contains the following information: 


e A 4-word header containing some control information about the very 
extended PAB. 


e An array of work element queues in descending priority. For example, 
queue 1 is the first queue in the array, and it has the highest priority; queue 
2 is the next queue in the array, and it has the next highest priority, etc. 
Each queue has the following structure: 


(Field PABVFRST) A pointer to the first WKE (head, or oldest) on this 
level's queue 

(Field PABVLAST) A pointer to the last WKE (tail, or youngest) on this 
level's queue 

(Field PABVSRVL) Service level 

(Field PABVSRVC) Service count 


The field PABRPHA in each PAB contains the address of an RPH that is either 
running or waiting. 


Note: In some PABs, PABRPHA might contain the address of an RPH, even 
though the RPH is not running or waiting. 
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Note the contents of these fields in each of the PABs, and have this information 
available when you contact IBM. 


Figure 5 shows how to find each PAB. Figure 6 shows the relative location of 
fields in a normal, extended, and slightly extended PAB. Figure 7 on page 75 
shows the layout for a very extended PAB. The DYPAB begins 10 bytes 
before the PAB. 


Note: The PAB pointers shown in Figure 5 are not contiguous in the ATCVT, 
but are shown that way for demonstration purposes only. 


ATCVT 


Configuration services PAB 

| VARY definition DYPAB 

Buffer pool expansion DYPAB 

PU services DYPAB 

PU services I/0 DYPAB 

LUS router DYPAB 

TSC no sessions DYPAB 

Network operator services DYPAB 
Session serialization PAB 
Session outage notification PAB 
CNS logon PAB 

Message DYPAB 


Termination subtask DYPAB 


Work Elements 


PABRPHA 


Figure 6. Normal PABs, Extended PABs, and Slightly Extended PABs 
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RPH 


PABRPHA 
PABVERY=1 


PABVFRST | PABVLAST | PABVSRVL | PABVSRVC 
PABVFRST | PABVLAST | PABVSRVL | PABVSRVC 


WKE 1—»WKE 2—>....—>WKE n 
Head Tail 


Queue 1 


Queue n 


Figure 7. Very Extended PAB 


7. Is the wait caused by pending I/O? 


Use the Input/Output Problem Determination (IOPD) facility to detect and report 
to the operator I/O operations that have been pending longer than a user- 
defined time limit. (For more information on using IOPD, see “Modify 
Input/Output Problem Determination” on page 209 and “MODIFY !OPD 
Command” in VITAM Operation.) 


When a VTAM process is waiting for a response, the process is represented by 
a waiting request element (WRE) queued to one or more LQABs within a single 
I/O LQAB group. 


The WRE points to an event ID (EID), which indicates the reason for the wait. 
(Wait state event IDs are described in Chapter 18, “Wait State Event Codes 
and IDs” in VIAM Messages and Codes.) 


Look for the WREs and corresponding EIDs in a dump by using Figure 8 on 
page 78 and Figure 9 on page 78 and the following steps. 


Note: You can use the VTAMMAP VTWRE formatted dump tool to count 
or help analyze WREs. See “VTWRE” on page 344 for information on using 


VTWRE. 
a. Find the address of the ATCVT at low-storage address X'408' 
or [J X'200'. 
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If this low-address location is not available in a dump, use the pointer 
in the MVS control block CVT (CVTATCVT) to find the VTAM control block 
AVT. Location X'00' in the AVT points to the ATCVT. 


The ATCVT is identified by release level at offset X'00' in the ATCVT. For 
VTAM V4R2, 


VA42 (X'E5C1F4F240404040') 
| VS42 (X'E5E2F4F240404040') 
VE42 (X'E5C5F4F240404040'). 


. Get the address of the I/O LQAB-group hash table from field ATCIOLQB. 


This hash table contains a number-of-entries field (LQHENTNM) followed 
by an array of table entries numbered starting with zero. 


. Use the hash table to find the |/O LQAB groups for active subareas. 


Each entry in the hash table is four bytes long and contains either 0, indi- 
cating an empty chain, or the address of the first LQAB group in a chain of 
I/O LQAB groups. 


Within each I/O LQAB group, the LQGLINK field (offset X'10') contains the 
address of the next LQAB group in the chain. An LQGLINK value of 0 
indicates the end of the chain. 


e To find the I/O LQAB group for a specific subarea: 


— Calculate the hash table entry number, N, by dividing the subarea 
number by LQHENTNM and taking the remainder. 


— Search the chain for hash table entry N to find the LQAB group 
whose LQGSUBA field (offset X'O0C') equals the subarea number. 


Note: I/O LQAB groups are allocated only when needed. Therefore, 
you do not find an LQAB group for a subarea that has had no I/O 
traffic. 


e To find all 1/O LQAB groups, search the chain for each entry in the 
hash table. 


d. Find all the WREs chained off of a given I/O LQAB group. 


e Each I/O LQAB group contains several different LQABs. Use the 
global LQAB (LQGGLOBL) to analyze wait states, because its chain 
contains all of the group's WREs. (Chains off of the other LQABs in 
the group usually do not contain all of the group's WREs.) You can 
locate LQGGLOBL at the beginning of the LQAB group (offset 0). 


e The LQAB starts with the LQABFRST field, which contains either 0, 
indicating an empty chain, or the address of the first (oldest) WRE for 
this subarea. 


e Within each WRE, the WREGFWD field (offset 4) contains the address 
of the next WRE in the chain. The end of the chain is indicated by a 
WREGFWD value equal to the LQAB address minus 4. 


e. Find the waiting event. Each WRE contains a WREIDCD field (offset 


X'32') that identifies the waiting event. Use explanations of wait state 
event IDs in Chapter 18, “Wait State Event Codes and IDs” in VTAM Mes- 
sages and Codes to find the reason for the wait. The address and length 
of the waiting event ID are in the fields WREIDP (offset X'24') and 
WREIDL (offset X'30'), respectively. 
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For additional information, check the WREDTA field (offset X'2C'). In 
most cases, this field contains a CPCB operation code. If so, look in 
Appendix G, “Control Point/Control Block (CPCB) Operation Codes” on 
page 1127 to determine what function the operation code represents. 


8. Is the wait caused by a non-l/O CPWAIT? 


When a VTAM process has suspended itself using a CPWAIT and is waiting for 
a matching CPPOST or CPPURGE, the process is represented by a WRE 
queued to one or more LQABs within a single non-I/O LQAB group. 


Analyze non-|/O CPWAITs using the steps described for pending I/O in step 7 
on page 75, with the following exceptions: 


e The IOPD facility does not detect and report these non-l/O events. 


e No arrays or hash tables are used. Instead, each of the six LQAB groups 
is pointed to directly by its own address field in the ATCVT. These address 
fields are as follows: 


ATCLUSMQ - logical unit services 
ATCMCQAB -— miscellaneous command 
ATCPULQB - physical unit services 
ATCNOSQ — network operator services 
ATCSSLQB — SSCP session services 1 
ATCSSMQB — SSCP session services 2 


e WREs for non-l/O events do not contain a CPCB operation code value in 
the WREDTA field. 
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Figure 8. Finding LQAB Groups 


Global LQAB (LQGGLOBL) 
within an I/0 or 
non-I/0 LQAB group WRE WRE 
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Figure 9. Finding Waiting Request Elements for an LQAB Group 
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9. Find waiting RPHs. 


The following steps give instructions for examining two kinds of wait conditions: 
(1) a process is waiting for a buffer, and (2) a process is waiting for some other 
resource. Both kinds of waiting processes are represented by request param- 
eter header (RPH) control blocks, but the RPH is found in different locations for 
each type of wait condition. 


e Step 10 explains how to find RPHs queued from a buffer pool control block. 
These RPHs show that the buffer pool cannot supply the required buffers, 
and as a result, the process is waiting. Note which buffer pool cannot 
supply the required buffers. 


e Step 11 explains how to find RPHs that indicate a waiting process. 
10. Find RPHs queued from buffer pool control blocks. 


A buffer pool that has no available buffers can cause a wait state. There are 
many reasons for running out of buffers (for example, incorrect allocation in the 
VTAM start options, a VTAM programming problem, or an application program- 
ming problem). Use the DISPLAY BFRUSE output obtained in step 2 on 

page 69, if you were able to get it, to analyze buffer pool usage. Or use the 
VTAMMAP VTBUF and STORAGE formatted dump tools. See “VTBUF” 
on page 327 and “STORAGE” on page 320. 


Examine location PCBFRPHA in each buffer poo! control block. 


Also, follow the chain at offset X'04' into the RPH to obtain the addresses of 
other RPHs waiting for the same pool. 


11. Find other waiting RPHs. 


Waiting RPHs indicate a VTAM process that has not been completed. To 
locate the waiting RPHs, search the large pageable buffer pool (LPBUF) by 
hand or use the VTAMMAP VTRPH formatted dump tool. For more infor- 
mation see “VTRPH” on page 339. Look at the formatted dump 
output. 


Use the VTAMMAP VTBASIC formatted dump tool to analyze the request 
parameter headers (RPH) in the component recovery area (CRA). This func- 
tion formats CRAs which contain RPHs. For more information see “VTBASIC” 
on page 326. 


Use the PRTDUMP command, specifying the VTBASIC option. This 
formats the CRAs, which contain the RPHs. 


12. Find RPHs waiting for locks. 


a. For each waiting RPH, look at the CRALxPTR fields. If any pointer (PTR) 
fields are non-zero, check the corresponding bit in CRALKACT. For 
example: 


e If CRAL1PTR is non-zero, look at the last bit in CRALKACT. 
e If CRAL2PTR is non-zero, look at the next-to-last bit in CRALKACT. 
e If CRAL3PTR is non-zero, look at the third-from-last bit in CRALKACT. 


lf the corresponding bit in CRALKACT is off (zero), the RPH is waiting for 
this lock. If the bit is on (non-zero), the RPH is holding the lock and might 
be waiting for another lock. On your list of waiting RPHs, add the name of 
the lock being held or waited for. (See Table 7 on page 80.) 
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b. If you cannot find any locks waiting or being held using step 12a, scan the 
LPBUF buffer pool again, and list all allocated buffers that contain a non- 
zero value in field CRALKACT. These buffers indicate which RPHs own 
locks, if any, and which locks are held. A CRA can hold several locks. For 
example, a value of X'06' indicates two locks being held: the RDTLOCK 
(X'04') and the VOCLOCK (X'02'). (See Table 7.) 


For each allocated buffer with a non-zero CRALKACT field, look at the 
CRALxPTR fields. (The buffer might contain a resume address.) A non- 
zero pointer field contains a lockword address. Find the lockword. The 
first word of the lockword shows a queue of RPHs waiting for that lock. 
Add these RPHs to your documentation list. 


13. Report the problem. 


Go to “Reporting the Problem to IBM” on page 112. 


VTAM Locks 


Table 7 includes a description of each VTAM lock, and Figure 10 on page 83 pro- 
vides information on VTAM lock pointers. 


Table 7 (Page 1 of 3). VTAM Locks | 


Name 
8SLOCK 


ADJLOCK 


AHNCBLOK 


BSBLOCK 


CIDLOCK 
CONNLOCK 


CONVLOCK 


CRYTOKLK 


Lvl 


Hex 
Value 


04 


10 


10 


08 


80 


20 


100 


80 
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Control 
Block 


MPNCB 


ADJSA 


AHNCB 


BSB 


CIT 
SAACB 


CONVT 


ATCVT 


Field 
Name 


MPN8SLK 


ATCADJLK 


AHNLOCK 


BSBLOCK 


CITLOCK 
SAA_CONN 


CONVTLOK 


ATCRYKLW 


Quantity 


One per multi- 
path channel 
(MPC) line 
represented 
by an MPNCB 


One 


One per active 
APPN host-to- 


~~ host channel 


PU 


One per 
session using 
SNA over 
TCP/IP 


One per 
session 


One 


One per 
APPC conver- 
sation 


One 


Function 


Serializes MPC outbound sched- 
uling in a VTAM operating under 
MVS with multiple CPUs and 
System/390* hardware. Ensures 
single remover for TPREMEL 
macros. 


Protects users of CIDCTL when 
adding or deleting an adjacent 
node. 


Serializes AHNCB PU PAB with 
AHNCB PC PAB. 


Protects updates and references of 
the BSB. 


Serializes changes to or deletion of 
FMCB. 


Serializes processing that estab- 
lishes paths to TCP/IP. 


Serializes deletions of RAB. 


Serializes use of the session key 
token chain. 
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Table 7 (Page 2 of 3). VTAM Locks 


Name 
DEBLKCT 


DEBLOCK 


DWALOCK 


HNTELOCK 


HNTERBLK 


HNTLOCK 


HSQCHAIN 


IAPTREE 
MVS 


INNLOCK 


LMELLOCK 


LMHTLOCK 


LSNLOCK 


NCBQ 


PDBUFLK 
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Lvl 


Hex 
Value 


20 


10 


80 


40 


80 


20 


08 


02 


100 


20 


10 


01 


100 


100 


Control 
Block 


DEBX3 


ACDEB 


DWA 


HNTE 


HNT 


HNT 


ATCVT 


SAACB 


ATCVT 


LME 


LMHDR 


LSNCB 


ATCVT 


ATCVT 


Field 
Name 


DEBLKPTR 


ACDLOCK 


DWALOCK 


HNTELOCK 


HNTERBLK 


ATCHNTLK 


ATCHSQLK 


SAAIAPLK 


ATCINNLK 


LMELLOCK 


LMHTLOCK 


LSNLOCKW 


ATCLNLOK 


ATCBUFLK 


Quantity 


One per ACB 
index table 
entry 


One per 
OPEN appli- 
cation 
program 


One 


One per minor 
node (per host 
element 
address) 


One per minor 
node 


One 


One 


One 


One 


One for every 
partner LU 
entry for every 
APPC applica- 
tion 


One per 
APPC applica- 
tion 

One per PU 
connection to 
an IBM 3172 


_ Interconnect 


Controller 
One 


One 


Wait 


Function 


Serializes queuing of an applica- 
tion's API requests with the closing 
of an ACB. 


1. Protects FMCB queue off 
ACDEB. 

2. Held by TSC and by OPEN or 
CLOSE. 


Used by certain disabled TSC 
modules to serialize use of the dis- 
abled work area (DWA). 


Serializes updates and references 
to control blocks based off the 
HNTE (RDTE, NCB, LUCB, 
FMCB). 


Serializes APPC conversion data in 
the RAB. 


Protects updates and references to 
HNT during most CIDCTL func- 
tions. 


Serializes usage of the HSQH 
queues. One lock is used to 
protect all of the queues. 


Serializes modifications and refer- 
ences to the IAP tree. 


Ensures that PiUs that are going to 
a node that is in slowdown mode 
are sent in FIFO order. 


Used to serialize access to partner 
LU information in the APPC logical 
unit mode (LM) Table. 


Used to serialize access to the 
APPC logical unit mode (LM) 
Table. 


Serializes the LSNCB PU PAB with 
the LSNCB PC and IR PABs. 


Serializes access to the queue of 
LSA NCBs anchored at 
ATCLNNCB. 


Allows the user to move in problem 
diagnosis trace data before the 
data is processed. 


Chapter 2. Collecting Documentation for Specific Types of Problems 81 


Wait 


Table 7 (Page 3 of 3). VTAM Locks 


Name 
PSTLOCK 


QDCBLOCK 


QUEUE 


RDTLOCK 


SDESLOCK 


SKTASGN 
SKTLOCK 


SLENTLOK 


TASKLOCK 
TCNLOCK 
TREELOCK 


VDLOCK 
VOCLOCK 


VRLOCK 


Lvl 


Hex 
Value 


80 - 


10 


100 


04 


80 


20 


80 


10 


40 


04 


20 


100 
02 


04 
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- Control 


Block 
ATCVT 


APNVT 


PAB 


ATCVT 


SOCCB 


SAACB 


SOCCB 


SLENT 


SAACB 


TCNCB 


SAACB 


ATCVT 
ATCVT 


VRBLK 


Field 
Name 


ATCPSTLK 
APNQDCBL 
PABLOCK 


ATCRDTLK 


SOT_DLCK 


SAA_ASGN 


SOT_LOCK 


SLE_LOCK 


SAA_TASK 
TCNLOCK 
SAA_TREE 


ATCVDLOK 
ATCVOCLK 


VRBLOK 


Quantity 
One 


One 


One per 


extended PAB 


One 


One per 
socket task 
(SOTCB) 


One 


One per 
socket task 
(SOTCB) 


One per 
session list 
entry 


One 


One 


One 


One 
One 


One per 
virtual route 
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Function 


Serializes queueing and 
dequeueing of FMCB to PSTFMCB 
queue. Serializes release of PST 
storage. 


Serializes access to the queue of 
QDCBs attached to the APNVT. 


Serializes queueing and 
dequeueing of work elements to an 
extended PAB. 


Protects users of CIDCTL 
(PAFIND). Obtained by PUNS 
when a network-addressable unit is 
to be added or deleted, or a use 
count decremented. 


Serializes usage of the socket 
descriptor list. 


Serializes assignment of sessions 
to the socket tasks. 


Protects SOCCB chain off the 
SOTCB. 


Protects updates and references to 
the session list entry state indica- 
tors and to the sequential list of the 
TP work queue. 


Protects SOTCB chain off the 
SAACB. 


Protects the BSB PCID and 
BSBSA tree for SNA/IP. 


Protects the SOCCEB tree. 


Serializes directed load processor. 


1. Serializes OPEN/CLOSE with 
VARY. 

2. Serializes VARY Activate, VARY 
Deactivate, and VARY ERP. 


Serializes usage of the VRBLK. 
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CRALKACT 


Level 1 Lock 
(CRAL1PTR) 


Level 2 Lock 
(CRAL2PTR) 


Level 3 Lock 
(CRAL3PTR) 


Level 4 Lock 
(CRAL4PTR) 


Level 5 Lock 
(CRAL5PTR) 


Level 6 Lock 
(CRAL6PTR) 


Level 7 Lock 
(CRAL7PTR) 


Level 8 Lock 
(CRAL8PTR) 


Level 9 Lock 
(CRAL9PTR) 


@eeoeeeede 


Wait 


<«————— Lock level held is relative to byte and bit 
position. Byte 3, bit 6 corresponds to lock 
level 2; byte 3, bit 5 corresponds to lock 
level 3; and so on. 
The value of this word corresponds to 
either a hexadecimal value or to a 
combination of hexadecimal values in 
Table 7 on page 80. 


Figure 10. Pointers to VTAM Locks 


Using the VARY INACT,FORCE Command 

If the operator attempted a VARY INACT,FORCE command, check whether the 
command can be completed or whether there is a VTAM problem. Determine this 
using the following steps according to the resource specified on the VARY INACT 
command. 


Note: 


Except for channel-attached SNA devices, if this command is issued to a 


resource with outstanding I/O, the command will not complete and VTAM must be 
recycled. 


1. Channel-attached physical unit or logical unit, SNA or non-SNA: 


a. Display the resource status. If it is PHLIN, PHLAC, PDLUC, or PSUB1, the 
channel is hung or a required interrupt is missing. 
b. If the status is PNFYx, go to step 11 on page 85. 


2. Link-attached SNA logical unit, switched logical unit: 
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a. Display the resource status. If it is PNFYx, go to step 11 on page 85. 
b. If it is anything else, there is a VTAM problem. 


3. Link-attached BSC 3270 logical unit: 


a. Display the resource status. You should see PDACL or PFDLU. 
b. Issue VARY INACT,FORCE for the NCP or CA major node that defines the 


device. 


c. If the deactivation succeeded and all lower-level nodes are inactive, 
message IST1085l indicates this. 
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d. If the deactivation failed, display the status of all the resources in the NCP 
or CA major node. 7 

e. If the status is PNFYx, go to step 11 on page 85. 

f. If it is anything else, there could be a VTAM or NCP problem. Go to 
“Reporting the Problem to IBM” on page 112. 


4. Link-attached SNA physical unit, switched physical unit: 


a. Display the resource status. You should see PDISC or PFDSC. 7 

b. Issue VARY INACT,FORCE for either the physical unit to which the device 
is attached, or for the NCP or CA major node that defines the device. 

c. If the deactivation succeeded and all lower-level nodes are inactive, 
message IST105I indicates this. 

d. If the deactivation failed, display the status of all the resources attached to 
the NCP. 

e. If the status is PSUBx, go to step 10. 

f. If the status is PNFYx, go to step 11 on page 85. 

g. If it is anything else, there is a VTAM problem. 


5. Link-attached BSC 3270 physical unit: 


a. Display the resource status. You should see PDACP or PFDCP. 

b. Issue VARY INACT,FORCE for the NCP or CA major node that defines the 
device. 

c. If the deactivation succeeded and all lower-level nodes are inactive, 
message IST105I indicates this. 

d. If deactivation failed, display the status of all the resources in the NCP or 
CA major node. 

e. If the status is PSUBx, go to step 10. 

f. If the status is PNFYx, go to step 11 on page 85. 

g. If it is anything else, there is a VTAM problem. 


6. Local SNA or non-SNA major node, switched major node: 


a. Display the resource status. You should see PSUBx. 
b. Issue VARY INACT,FORCE for any minor nodes that are not inactive. This 
should allow deactivation to be completed. 


7. Link: 
a. Display the resource status. You should see PDLNK. 


b. Issue VARY INACT,FORCE for the NCP to which the link is attached. This 
should allow deactivation to be completed. 


8. Channel-attached NCP: 


a. Display the resource status. You should see PDISC. 
b. Press the RESET LOAD button on the communication controller. This 
should allow deactivation to be completed. 


9. Link-attached NCP: 


a. Display the resource status. You should see PSUBx. 
b. Display the status of the lower-level nodes. 

c. If the status is PNFYx, go to step 11 on page 85. 

d. If the status is anything else, there is a VTAM problem. 


10. PSUBx status: 


a. Display the status of the lower-level nodes to find any pending states. 
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b. Deactivate any active or pending nodes. This should allow deactivation to 
be completed. 


11. PNFYx status: 
a. For application programs with an NSEXIT exit routine: 


If the VARY INACT,FORCE command is unable to complete, there is a 
VTAM problem. Otherwise, deactivation should complete. 


b. For application programs with only a LOSTERM exit routine: 


1) If the application program has issued a CLSDST macroinstruction, 
deactivation should complete. 


2) If the application program has not issued a CLSDST macroinstruction 
for the logical unit, issue a second VARY INACT,FORCE for the logical 
unit in question. If that does not correct the problem, you might need 
to cancel the application program to allow the deactivation to complete. 
(Cancelling the application program terminates all of the LU-LU ses- 
sions with the application program.) 


c. For application programs with neither exit: 


Deactivation does not complete until the application program issues 
CLSDST, the application program closes its ACB, or the operator cancels 
the application program. 


Return to step 2 on page 69. 
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Loop 


If the problem is a loop, use the procedure in Figure 11 on page 87 to collect the 
following documentation. 


Note: lf you are using TSO/VTAM, use this procedure. You do not need to 
go to Chapter 3, “Collecting Documentation for TSO/VTAM Problems (MVS).” 


e System console log 
e Messages associated with the loop (if any) 
e Failing module ID 
e Dump mie 
— [SS Dump of the VTAM address space that i is looping 
—- Dump of the virtual machine that is looping 
- Dump of the VTAM partition, SVA, and supervisor 
Error file output (LOGREC) 
SYSREC 
For a problem associated with a specific device: 
— VIT trace output (all except LOCK) 
I/O trace output 
Session trace data (if using the NetView program) 
Session awareness data (if using the NetView program) 
NetView report (if using the NetView program) 
GTF CCWTRACE output (if available) 
VM branch trace 
VSCS internal trace 
CP internal trace 
CP virtual machine trace 
GCS internal trace 
SDAID CCWD trace output. 


I 
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Trace the loop 
and, for re-create, start 
VIT traces 


Obtain system console 
and LOGREC output 


Message Yes Find 


symptom 
? 


message ID 


No 


Yes 


Device 
symptom 
? 


Link-attached 


device 
? 


No 5b 


VIT ClO trace 
CCW trace, or 
session trace data, 
and SAW 


Many 


errors received 
an 


Yes 


Device 


problem 


Loop 


Message procedure 
step 4 


5a 


Get VIT PIU trace, 
1/O trace of NCP, 
or session trace data 


Many 

RECMS PIUs 

received 
? 


No 


Trace ERP 


routines 


No 


Figure 11 (Part 1 of 2). Overview of the Loop Procedure 
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Loop Yes 


No 


issue PSW restart 
and find the 
failing module 


Determine the 
module name 


Find the name of 
the module whose 
address is in 
register 12 


Find the name of the 
module whose address 
is in register 14 


Have 
system trace 
available 


Find the 
looping module 
names 


Report or go to 


Have VIT Examine the Failing Module 


available trace output 


procedure 


Figure 11 (Part 2 of 2). Overview of the Loop Procedure 


Following is a description of each step shown in Figure 11 on page 87. 


88 VTAM V4R2 Diagnosis aa LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” Loop 
Licensed Materials — Property of IBM 


1. Trace the loop. 


Loop problems might involve many modules or a single module. If possible, 
trace the looping instructions. Using the Operator's Reference for your host 
processor, instruction-step through the looping addresses. Save these 
addresses for use in diagnosing the problem. 


In an enabled loop (PSW is enabled for interruptions), PSWs with 
low addresses might indicate a normal system process. Because most VTAM 
routines are enabled, look for PSW addresses that are in the range of the 
VTAM virtual machine, partition, or SVA. 


Take a dump and determine which module is looping by checking the 
PSW addresses in the CLKC entries for a repeating pattern. 


lf the VIT was running when the loop started, look for any exception conditions 
that might have led to the loop. If the internal trace was not running, you might 
have to re-create the problem to get the trace at the time of the loop. Set the 
internal trace to MODE=EXT to record the trace entries in an external file. 


Display the PSW and REGS several times to trace the loop, using the 
command #CP DP G. 


When VSE is native on the CPU, stop the processor and instruction-step 
the CPU to get the PSWs of the loop. When VSE is a guest of VM, get the 
PSWs with the command #CP TRACE | ALL. Display the PSW and REGS 
several times to trace the loop, using the command #CP D P G. 


2. Look for a VSCS loop. 


If you are using VSCS, go to “Wait and Loop Problems” on page 159. If you 
cannot identify the problem using those procedures, return to this procedure. 


3. Get dump output. Get a dump of VTAM: 


° Issue the DUMP command, or press the Program Restart key. 

° Issue #CP VMDUMP 0- DSS FORMAT GCS, with the appropriate 
options. 

° Issue the DUMP command. 


If the loop is disabled, the system console is not available for 
input, So take a stand-alone dump. (See “Stand-Alone Dump” on page 214 or 
“Stand-Alone Dump Utility” on page 216.) | 


4. Get the system console log and LOGREC or SYSREC output. 


The system console log might contain information, such as error messages, 
that can help you diagnose the problem. Also, print the LOGREC or SYSREC 
file. 


Use the LOGDATA option to print the in-core LOGREC buffers. See 
Table 80 on page 1165 to determine what book has information on LOGDATA. 


5. ls a message involved? 


Determine whether there are any messages associated with the loop, such as 
a particular message always preceding the problem, or the same message 
being issued repeatedly. If so, add the message numbers to your problem doc- 
umentation and go to the message procedure, step 4 on page 94. 


6. Is it a device error? 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Chapter 2. Collecting Documentation for Specific Types of Problems 89 


Loop 


90 VTAM V4R2 Diagnosis 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


For any kind of device error, you should first check the NetView report (if you 
have the NetView program) and then the LOGREC or SYSREC output. 


Does the LOGREC or SYSREC output show repetitive entries for the same 
kind of error on a particular device? If so, VTAM is receiving several different 
errors from that device. 


a. If the LOGREC or SYSREC error records are for a link or link station 
attached to a communication controller, get VIT PIU records and an I/O 
trace of the NCP. If you have the NetView program, get session trace data 
or session awareness data for the NCP. If the error records are for a link 
or device attached to a communication adapter, get VIT PIU records or a 
dynamic trace of the communication adapter. 


If the trace shows continual arrival of RECMS PIlUs, then the repetitive 
entries in LOGREC or SYSREC are caused by a device error. 


Note: For information on counting PIUs see “Counting Request/Response 
Units (RUs)” on page 426. 


b. For channel-attached devices, use one or more of the following traces for 
the device to determine whether VTAM is receiving many errors: 


e VTAM internal trace with ClO option 

e Session trace data (if using the NetView program) 

e Session awareness data (if using the NetView program) © 

° CCWTRACE (if available) 

° SIO and I/O traces for CP and GCS 

° SDAID program with the SIO and I/O trace types and the output 
of CCWD. | 


If VTAM is receiving many errors, the problem is probably in the device. Runa 
CIO VIT trace to trace execution of the VTAM ERP routines. Then continue 
with step 7. 


. Is the loop traced? 


If you were able to instruction-step through the loop, go to step 15 on page 92; 
otherwise, continue with step 8. 


. Find the failing module. 


Use the PSW to find the failing module. 
e [SS The PSW is found in LOGREC output, the SDWA, or the RTM2WA. 


When you use PSW RESTART to terminate a looping task, a LOGREC 
entry is created with a completion code of X'071' for the task. An 
RTM2WA is also created for the task. Use the LOGREC record and the 
RTM work area to locate the failing module. See the diagnostic books 
listed in the “Bibliography” on page 1159 for your operating system for help 
in locating the PSW in dump output. 


Depending on the PSW bit 32, the last 3 bytes (24-bit mode) or 4 bytes 
(31-bit mode) of the PSW contain the address being executed at the time 
of the dump. Scan the dump output to find the address given in the PSW. 
See Table 80 on page 1165 to determine what book contains more infor- 
mation on PSWs. : 


Note: Addresses might not always be in numeric order because the dump 
does not always generate output in sequential order. 
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If you cannot find the address, the dump might not contain the relevant 
portion of main storage. For example, the address might be in LPA 
storage. Have this portion of storage dumped, or use output from LPAMAP 
to identify the module, and proceed as above. 


e [MJ You should have found the PSW when you issued DISPLAY PSW in 
step 1 on page 89. 


e [a You should have the PSWs from step 1 on page 89. 


Note: Addresses might not always be in numeric order because the dump 
does not always generate output in sequential order. 


Note: The VTAMMAP VTFNDMOD formatted dump tool can be used to 
gather the module information described in steps 9, 10, and 11. 


9. Find the module name containing the failing address. 


VTAM identifies modules with an EBCDIC module name and the Julian date 
(and, if appropriate, the latest PTF applied) at or near the beginning of most 
modules. This module identifier is usually in the form: 


| IST Xxxxx yy.ddd [nnnnnnn] 


where xxxxx is the last five characters of the module name, yy.ddd is the Julian 
date the module was assembled, and nnnnnnn is the latest PTF (if any) that 
has been applied to this module. 


To find the module ID, start at the failing address and scan upward (in 
descending address order) along the right side of the dump listing. The module 
ID is printed in EBCDIC. Add the module name to your documentation list. 


10. Find the module pointed to by register 12. 


General register 12 (X'0C') is normally the base register for VTAM modules. 
In a VTAM loop, register 12 should point to the same module found in step 11. 
If not, add this module name to your documentation list. 


11. Find the module pointed to by register 14. 


General register 14 (X'OE') might point to a module that called the routine that 
is looping. Add this module name to your documentation list. 


Add the module names from steps 9, 10, and 11 to your documentation list. 
You can report the problem next, but you might need to continue with step 12. 


12. Get the system trace output. 


The system trace might show many external and I/O interrupts. The PSW 
addresses in system trace entries will be part of the loop. 


13. Get the VIT output. 


The VIT is useful in determining the reason for a loop, such as a process being 
continually re-dispatched for the same request. Get the VIT output. If you 
require VIT options in addition to the default options (API, MSG, PIU, SSCP, 
and NRM), start a VIT in addition to the default and specify MODE=EXT. If 
VTAM does not accept the command it might be necessary re-create the 
problem. For more information on using the VIT, see Chapter 9, “Using the 
VTAM Internal Trace (VIT).” 


14. Examine the trace entries. 
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By examining all of the trace entries, you might be able to determine whether 
there is a loop. The most obvious loops would be a module or modules getting 
continual control of the VTAM system, or a control block chaining to itself. 
Check the output of the PSS option to see which VTAM routines are getting 
control. If you see a pattern of repetition in the trace entries, it does not neces- 
sarily mean VTAM is looping. Some VTAM processes are timer-driven and 
repeat periodically. 


Notes: 


a. Get the trace information and examine the clock comparative entries for 
repeating PSW addresses. For short loops the repeating PSWs show the 
extent of the loop | 


b. The absence of any apparent loop does not necessarily mean VTAM is not 
looping. The loop might not contain a VTAM trace point. 


lf a module or modules are looping, get their addresses from the trace entries. 
Step 15 explains how to find the module name. 


If you find a control block chained to itself, or if a queue of control blocks is in a 
cycle, try to identify the control block. Most control blocks have a 1-byte ID at 
offset X'00'. See the control block ID codes in Appendix H, “Storage and 
Control Block ID Codes” on page 1137 to identify the control block name. 


Find the module names. 


Note: [[{MJ You can also use the VTAMMAP VTFNDMOD formatted dump 
tool to find the module ID. See “VTFNDMOD” on page 332. 


Use the addresses found in step 14 on page 91 to find the module names 
involved in the loop. 


To find the module ID, start at the failing address and scan upward (in 
descending address order) along the right side of the dump listing. The module 
ID is printed in EBCDIC. Add this module ID to your documentation list. Con- 
tinue with step 16. 


Report or go to the failing module procedure. 


lf you determined the module names, go to “Failing Module” on page 109. 
Otherwise, you are ready to contact IBM. Go to “Reporting the Problem to 
IBM” on page 112. 
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Message Problem 
If the problem is a message, use the procedure in Figure 12 to collect the following 
documentation: 


e Issuing module 

e Message number 

e System console log 

e Dump output if required 
e¢ VIT output. 


Note: If your installation changed the text of the message, the message ID might 
not be included, or might not match the ID of the message as it appears in VTAM 
Messages and Codes. Therefore, it is recommended that you re-create the 
problem using the VTAM-supplied message text. Otherwise, determine what 
VTAM-supplied message text corresponds to the message text your installation is 
using. 


Problem 
in message 


itself 
? 


Yes 


Refer to Messages 
and Codes manual 


Chapter 3 


Get dump 
output 


Storage 
problem 


4 


Identify 
issuing module 


Issuing 
module 
known 


Failing Module 
procedure 


No 


Figure 12. Overview of the Message Procedure 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Chapter 2. Collecting Documentation for Specific Types of Problems 93 


Message Problem 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Following is a description of each step shown in Figure 12. 
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1. Report if the problem is in the message itself. 


If the content of the message is incorrect or the meaning of the message is not 
clear, go to “Reporting the Problem to IBM” on page 112. 


. Follow the recommended action. 


For all messages, see VTAM Messages and Codes for recommended operator 
and programmer actions. (See the list of VTAM books in the “Bibliography” on 
page 1159 for the appropriate form number.) In addition: 


e Identify the issuing component. 
e If the message indicates a storage problem, go to step 3. 


° lf the message indicates a TSO/VTAM problem, see Chapter 3, “Col- 
lecting Documentation for TSO/VTAM Problems (MVS)” on page 113. 


° If message DTISQ9I indicates a VSCS problem, see “Message Prob- 
lems: Message DTIS99I Indicates a VSCS Internal Error” on page 176. 


The following list shows message prefixes and the components that issue those 
messages. 


Prefix Issuing Component 
ELM Logon Manager 
DTI vSCS 

IKT TSO/VTAM 

IST VTAM 

ISU Sockets over SNA 
Notes: 


a. If the message starts with any other characters, it is issued from another 
network component or the operating system. | 


b. Messages that begin with the prefix ISTF are issued by the VTAM 
dump analysis tools and the VTAM internal trace (VIT) analysis 
tool. 


Help information for ISTF messages is available as a part of each tool by 
pressing F1. Therefore, these messages are not documented in VIAM 
Messages and Codes. 


See Chapter 7, “Using VTAM Dump Analysis Tools (MVS)” on page 237 
and Chapter 10, “Using the VIT Analysis Tool (MVS, VM)” on page 411 for 
additional information on the dump and trace analysis tools. 


. Is there a storage problem? 


If there is a storage problem, see “Storage Problem Procedure (MVS)” on 
page 105 for additional information. 


If there is not a storage problem, continue with step 4. 


. Identify the issuing module. 


Try to identify the module issuing the message. If the MSGMOD start option is 
active or the MODIFY MSGMOD command is issued before the problem 
occurs, the message text contains the last five characters of the issuing module 
name. Add the message prefix to the module name, and add this name to 
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your problem documentation. (To modify the module identifier in messages, 
see “Modify Message Module Identification” on page 210.) 


The VTAM internal trace MSG entries contain the message number, the save 
area address, and the module ID (the 4th, 5th, 6th, 7th, and 8th characters of 
the module name). Use these to identify the issuing module. If the trace entry 
contains no module identifier, use the caller's address from the trace entry. 


5. Report or go to the failing module procedure. 


lf you Know the name of the issuing module, go to “Failing Module” on 
page 109. If you are unable to determine the issuing module or resolve the 
problem, go to “Reporting the Problem to IBM” on page 112. 
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Incorrect Output 
If the problem is incorrect output, use the procedure in Figure 13 on page 97 to 
collect the following documentation: 


Specific output that is incorrect 

Device type (if appropriate) 

Buffer contents trace output 

VIT trace output (all except LOCK) 

Session trace data (if using the NetView program) 
Session awareness data (if using the NetView program) 
e Network controller line trace output (3710 only) 

e GTF CCWTRACE output (if available) 

e For TSO problem, TGET/TPUT trace 

¢ CP internal trace 

e CP virtual machine trace 

¢ GCS internal trace 

e For VSCS problem, VSCS internal trace 

¢ SDAID program output 

e ICA line trace output 

e Network problem: 

— Line trace 

— Generalized PIU trace (GPT) 

— Transmission group (TG) trace 

— Scanner interface trace (SIT) for 3720, 3725, and 3745. 
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Incorrect Output 
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Figure 13. Overview of the Incorrect Output Procedure 


Following is a description of each step shown in Figure 13. 


1. Document the incorrect data. 


or application 


Application 
program 


Application 
program problem 


Incorrect Output 


Most incorrect output problems pertain to data contained in a PIU. This can be 
incorrectly formatted user data, routing information that is not valid, or other 
types of missing or incorrect data. These types of problems are generally diffi- 
cult to diagnose, as they show up only at the end-user locations. From the 
following list, choose all the symptoms that apply to your problem and add 


them to your problem documentation: 


e Cursor is in the wrong place or missing. 
e Format of data is incorrect. 


e Data is truncated. 
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Data is incorrect. / 
Data is missing. . 
Problem is related to an application program macroinstruction. 

Screen is improperly formatted. 

Session is hung. 

Terminal is hung. 


Note: The term “hung terminal” means the user is prevented by the system 
from entering data. 


. Determine the device type. 


If the problem is associated with a specific device type, add the device type (for 
example, 3277, 3278, or 3279 terminal) to your problem documentation. 


Is ita TSO/VTAM user problem? 


If the incorrect output problem involves TSO/VTAM, go to “Screen Management 
Problems” on page 121. 


Is ita VSCS user problem? 


lf the problem involves a VSCS user, follow the procedure in “Incorrect Output 
Problems” on page 178. 


. Get network trace and dump output. 


Re-create the problem with the following service aids active: 


e Start the VTAM buffer contents trace for the failing application program and 
terminal logical units. 


e If you have an IBM 3710 Network Controller, start the network controller 
line trace. It traces information passing to and from a 3710. 


e Start the VIT with MODE=EXT. Unless APPC is involved, do not specify 
the APPC option. Unless you suspect that a lock is not working, do not 
specify the LOCK option. Do not specify the MSG option. This shows the 
type of requests being processed between the application program and the 
end user or terminal, and the control meonmenels for routing, pacing, and so 
on, in each PIU sent in the network. 


e You should start the generalized PIU trace if the problem involves lines or 
devices attached to a communication controller. This shows how far the 
PIU got within the NCP and what the PIU looked like (its control informa- 
tion) when it was sent to the line. 


e If the problem involves lines or devices attached through an 
integrated communication adapter (ICA), start the dynamic trace of the ICA. 
This shows any problem related to the line. 


e If you have the NetView program, you can use the session trace data to 
determine the requests and responses received and sent by VTAM and the 
other network nodes. 


e If it is available, you can use GTF CCWTRACE and [J TRSOURCE 
and [a the SDAID program to trace the CCWs, I/O interruptions, and all 
CCW data for each Start I/O issued by the system. For more information 
on these traces, see the diagnostic books for your operating system. 
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e As soon after the problem occurs as possible, take a dump of the applica- 
tion program, VTAM, and [J TSO/TCAS. Stop all traces, and format the 
dump and trace output for online viewing. 


The dump is used to reference storage addresses, such as control blocks and 
module entry points. The trace data shows at what point the data was modi- 
fied, and what PABs the data was on as it was processed by VTAM. Take the 
dump during the re-create, when the traces are running. A dump taken earlier 
might not be accurate because the terminal device might have been deacti- 
vated and reactivated. This would allocate a different set of control blocks. 


For more information on dumps and traces, see Chapter 6, “Using Dumps” and 
Chapter 8, “Using Traces.” Operating system service aids are documented in 
operating system books. 


6. Examine the trace output. 


Examine the individual trace entries to find the failure. If the problem concerns 
user data format, and the buffer contents trace or PIU trace does not show the 
incorrect data, use the output from the VIT trace with the SSCP option. 


Use one of the following commands to see whether data is correct when it is 
sent to the NCP or logical unit: 


° GTF CCWTRACE (if available) 
© [QJ TRSOURCE 
° SDAID. 


The VTAM internal trace records CC2, Cl2, and CO2 contain the first 24 bytes 
of this data. 


When output data is correct: 


If the traces show that the data or the control information in the RH/TH as it 
leaves VTAM is correct, the problem is not in VTAM or the application program; 
go to step 9. If the data going to the network is not valid, continue with step 7. 


When input data is incorrect: 


If the traces show that VTAM is receiving invalid data from a source external to 
VTAM, the problem is in the network; go to step 9. If the data from the network 
is valid, the problem is in VTAM or an application program; continue with step 
7. 


7. Is it VTAM or an application program? 


The problem has been narrowed down to VTAM or the application program. 
Examine each trace entry to determine whether the information from the appli- 
cation program was incorrect. If VTAM seems to be responsible, go to 
“Reporting the Problem to IBM” on page 112; otherwise, continue with step 8. 


8. Is more application program help needed? 


For IBM application programs such as CICS or IMS, you can find additional 
diagnostic help in the IBM application program books. If you decide that the 
problem is with an IBM application program, contact the appropriate IBM repre- 
sentative for that product. 


9. Is the problem with an external network device? 
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The problem has been narrowed down to the VTAM network, but not to VTAM 
itself. Try to identify the device or program responsible. You can use service 
aids, such as the NCP line trace, generalized PIU trace, or transmission group 
trace, to trace data flow between the NCP and terminal logical units. For infor- 
mation on how to use these traces, see “Traces Provided by NCP” on 

page 384. For a 3720, 3725, or 3745, use the scanner interface trace (SIT) to 
distinguish between NCP problems and line or terminal problems. 


If you suspect the NCP, see Table 80 on page 1165 to determine what book 
contains information on troubleshooting NCP problems. 


Chapter 6, “Using Dumps” on page 213 explains how to use system dumps, 
including the NCP dump. Contact the appropriate IBM representative for the 
device or program identified as the cause of the problem. 


The ICA line trace can be used to discriminate between a VTAM 
error and one that is related to a device or line attached through an ICA. For 
more information, see the diagnostic book for the host processor. 


Report the problem. 
Go to “Reporting the Problem to IBM” on page 112. 
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Performance Problem 


If the problem is performance, use the procedure in Figure 14 on page 102 to 
collect the following documentation: 


e System console log 
7 LOGREC 
— [a SYSREC 
e¢ Tuning statistics 
e SMS (buffer use) trace output 
e Network controller line trace output (8710 only). 


Note: Performance problems do not generally indicate a VTAM problem. 
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Figure 14. Overview of the Performance Procedure 
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Following is a description of each step shown in Figure 14 on page 102. 
1. Get LOGREC or SYSREC output. 


Performance problems are often caused by hardware errors. These hardware 
errors cause software error recovery processing to occur, which degrades 
system performance. For this reason, you should get LOGREC or SYSREC 
output. LOGREC or SYSREC might show a large number of hardware errors 
for a particular device or group of devices. If the errors are limited to a single 
device, a hardware error is probably the cause. If the errors appear on many 
or all terminals of one type, software is more likely to be the problem, although 
hardware might still be at fault. If you suspect a particular device type, add it to 
your documentation list. 


2. Examine the system console log. 


The system console log might contain messages to help diagnose a problem. 
Add the message ID to your documentation list: 


The message prefix is either IST, ELM, IKT, or ISU. 
The message prefix is either IST or DTI. 
The message prefix is IST. 


The system console log might also contain information about command prob- 
lems. For example, operator commands might be taking too long to complete. 
Add the command name (for example, VARY ACT) to your documentation list. 


3. For TSO/VTAM, see Chapter 3, “Collecting Documentation for 
TSO/VTAM Problems (MVS)” on page 113. 


If you are using TSO/VTAM, go to “Performance Problems” on page 129. If 
you cannot resolve the problem with that procedure, return to this procedure. 


4. For VSCS, see Chapter 4, “Collecting Documentation for VSCS Prob- 
lems (VM)” on page 131. 


If you are using VSCS, and you have not identified the cause of the problem, 
go to “Performance Problems” on page 182. If you do not resolve the problem 
with that procedure, you should return to this procedure. 


5. Get tuning statistics. 


lf the performance problem is associated with traffic through a channel-attached 
host, a channel-attached communication controller, a channel-attached SNA 
physical unit, or multipath-channel-attached resources, it might be helpful to get 
tuning statistics for VTAM. (For more information on tuning statistics, see 
“Modify Tuning Statistics” on page 212.) 


6. Get output from the SMS (buffer use) trace. 


You might have enough information to identify the problem. If so, go to 
“Reporting the Problem to IBM” on page 112. If you do not, continue with this 
step. | 


a. Buffer pool expansion can cause performance problems. During VTAM 
initialization, error recovery, and VARY command processing, buffer usage 
is higher than normal. If buffer expansion is used, buffer pools should not 
expand except during such peak periods. Thus, what appears to be high 
buffer usage could be normal depending on the level of system activity. 


Run the buffer use trace (TYPE=SMS). For information on how to start the 
trace and examine the output, see “SMS (Buffer Use) Trace” on page 377. 
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_ Coding the SNAPREQ start option causes trace entries to be written more 
often, providing a more comprehensive picture of buffer usage. See 
“SNAPREQ’” in the VTAM Resource Definition Reference. — 


b. Using the time stamps in the system console and buffer use trace, 
correlate an excessive number of buffer pool expansions or large number 
of buffers used from a single pool with network activity recorded on the 
console. Constant high usage of a buffer pool might show that not enough 
buffers were allocated at VTAM initialization to properly support the level of 
network activity. Also look for a buffer pool that continually grows; buffers 
might not be released by some VTAM routines. Add the name of a partic- 
ularly active buffer pool (for example, LPBUF or lIOBUF) to your documen- 
tation list. 


Get output from the network controller line trace. 


If an IBM 3710 Network Controller is installed, start the network controller line 
trace. This traces information passing over the lines to and from a 3710. (For 
more information about this trace, see “Network Controller Line Trace (3710 
Only)” on page 389.) Print the trace output with TAP. 


. Get additional documentation. 


If no solid indication of a problem is apparent at this point, run the VIT with 
OPT=(PSS,API,SSCP,PIU') and MODE=EXT. This creates a history of VTAM 
activity. At the time of performance degradation, stop VIT and take a console 
dump of VTAM. (See your operating system manuals for information on how to 
take a dump.) Load the dump and trace output for future reference. 


. Report the problem. 


Go to “Reporting the Problem to IBM” on page 112. 


1 If you are running an LU 6.2 application, include the APPC VIT option in this list. 
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Storage Problem Procedure (MVS) 
This procedure focuses on storage problems that occur in the common service area 
(CSA) or private storage area. For general information on CSA storage and an 
explanation and description of storage pools, see Chapter 11, “Tuning VTAM for 
Your Environment” in the VTAM Network Implementation Guide. 


Procedure Steps 
The information in this section is taken from the following VTAM storage diagnosis 
information APARs: 


1106752 ~=An Introduction/Overview 
1104548 Documentation Requirements 
1107563 Private Storage Problems 
1107564 CSA Storage Problems 


1. Check for common CSA and private storage messages. 


Use the following messages to determine if the storage shortage is occurring in 
CSA or private storage. If the message is issued frequently or continuously, 
this indicates that a dump is needed to provide additional information. 


Table 8 lists the messages that are associated with CSA storage problems. 
See the description of the message in VITAM Messages and Codes for addi- 
tional information. 


Table 8. IST Messages Associated with CSA Storage Problems 


Message 
number Description 
IST154 Indicates that expansion failed for one of the fixed length buffer pools in 


ECSA subpool 231. The error code displayed in the message provides addi- 
tional information. 


IST5611 Indicates that SLOWPT has occurred in one of the fixed length buffer pools 
in ECSA subpool 231. 


e If this message only occurs occasionally, you might need to do some 
tuning in this area. See Chapter 11, “Tuning VTAM for Your 
Environment’ in the V7AM Network Implementation Guide for additional 
information. 


e If the console is flooded with this message, you might have a CSA 


problem. 
IST562! Indicates that you have reached the limit you have set for CSA or CSA24. If 


this message repeats soon after you issue the MODIFY CSALIMIT or 
MODIFY VTAMOPTS command to increase the limit, further investigation of 
the contents of CSA will be required. 


IST5641 Indicates that a GETMAIN failed for the CSA subpool specified in the 
message. The specified subpool might be the source of the CSA problem or 
the problem might be caused by another CSA subpool that is affecting the 
subpool displayed in the message. Further investigation into the contents of 
storage will be required. 


Table 9 on page 106 lists the messages that are associated with private 
storage problems. See the description of the message in VTAM Messages and 
Codes for additional information. 
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Table 9. IST Messages Associated with Private Storage Problems 

Message 

number Description 

IST563! Indicates that the MAXPVT value has been reached. This value specifies 
how much private area subpool 229 storage VTAM can use within the 
address space of the application program displayed in the message. This 
indicates a problem with the application and not a VTAM problem. 

IST565l Indicates that a GETMAIN failed for the VTAM private area subpool dis- 

played in the message. The specified subpool might be the source of the 

problem or the problem might be caused by another subpool that is affecting 
the subpool displayed in the message. Further investigation into the con- 
tents of storage will be required. 

IST566! This message is the same as IST563I except that MAXPVT was not speci- 


fied on the APPL definition statement. This message does not indicate a 
VTAM problem. 


2. Request a full dump. 


If storage-related messages are issued frequently or continuously, dump VTAM 
common and private storage areas. The dump can help you determine the 
location of the storage problem. 


See “Formatting and Printing Dump Output (MVS) (VM)” on page 232 for 
information on the VTAM interactive problem control system (IPCS). 


Several storage-related dump analysis tools are available. See 
“STORAGE” on page 320, “VTAM” on page 323, and “VTBUF” on 
page 327 for descriptions of these tools. 


lf external trace is active, see “Analyzing Storage” on page 417 for informa- 
tion about analyzing storage using the VIT analysis tool. See “Internal and 
External Trace Recording” on page 401 for additional information. 


Notes: 


a. 


The best dump for diagnosing VTAM storage problems is a full dump. | 


If the dump is partial, examine the reason text of MVS message IEA911E 
to correct the problem so that you can obtain a full dump. The most 
common reason for a partial dump is that the dump dataset is not large 
enough. In this situation, calculate the DASD space requirements and real- 
locate the dump dataset. 


For a complete description of the required documentation for storage prob- 
lems, see information APAR 1104548. 


. Although VTAM detects storage shortages in the common storage area, 


VTAM might not be causing the shortage because this area is shared by all 
address spaces. 


3. Use IBMLink to find additional problem determination information. 


If you have access to IBMLink, take the following actions: 
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Review the appropriate VTAM storage diagnosis information APAR(s). See 
“Procedure Steps” on page 105 for a list of these APARs. 


Use your error messages and dump to determine key words for searching 
IBMLink for additional information and known problems. 
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If you do not have access to IBMLink and need additional assistance, go to 
step 4 on page 107. 


4. If you need additional assistance, contact the IBM support center at 
1-800-237-5511. 
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Documentation Problem | 


Note: Before using this procedure, be sure that documentation is the problem. A 
VTAM problem might cause the documentation to appear wrong. 


If the problem is documentation, use the procedure in Figure 15 to collect the fol- 
lowing documentation: 


e Incorrect information 
e Form number of book. 


Documentation 


Identify the Record the 
incorrect information manual number 


Figure 15. Overview of the Documentation Procedure 


Following is a description of each step shown in Figure 15. 
1. Identify the incorrect information. 


Add to your documentation list the name of the macro, operand, or procedure 
that is incorrectly defined or explained in the documentation (for example, “line 
trace.”) 


2. Record the form number. 


Add the form number of the VTAM book to your documentation list in the form 
ccnnnnnnrr (omit the dashes in the number; rr is the revision level). For 
example, report the form number of this book as LY43-0065. 


3. Report the problem. 
Go to “Reporting the Problem to IBM” on page 112. 


Note: Report a documentation problem only when it causes a VTAM problem. 
For suggestions, comments, or questions about VTAM books, use the Reader's 
Comment Form at the back of the book. 
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Use this procedure if you have identified a failing VTAM module in one of the other 
procedures (abnormal end, message, or loop). Figure 16 shows an overview of 
the failing module procedure. 


Use this procedure to get the following documentation: 


e Module ID and PTF eye-catcher 
e Caller of module 
e VIT output. 


Determine which 
request or command 
invoked the process 


Have VIT Report 


available 


Figure 16. Overview of the Failing Module Procedure 


Following is a description of each step shown in Figure 16. 


1. Determine the caller of the service routine. 


The failure might have occurred in a VTAM service routine used for many pur- 
poses. Determine the caller of the service routine. Use the save area con- 
ventions in “Using Save Area Module Linkage Conventions—Subarea” on 


page 552, or if you know the save area address use the ISTVSAVE 
CLIST. 


2. Examine the work element structure. 


If your problem type is an abnormal end or loop, and the module is dispatched 
under control of VTAM PSS, find the CRA/RPH associated with the process. 
(See step 10 on page 79 in the wait procedure.) The RPHWEA field (at offset 
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X'1C') usually points to the work element associated with the process at the 
time it was dispatched. To identify the work element, see “Using Save Area 
Module Linkage Conventions—Subarea’” on page 552. 


From the work element, it might be possible to identify an SNA 
request/response type, an operator command, or an application program 
request that ultimately caused the process to receive control. Add this request 
or command name to your documentation list. 


lf the RPHWEA field does not point to the work element, continue with step 3. 
3. Have VIT information available. 


Use the VIT options PSS and SMS to get more information about how the 
failing module received control or where the relevant control blocks are found. 
To obtain the address of the work element and the module name of the 
process entry point, use the last dispatch (DSP) entry for the failing process. 


Continue with “Reporting the Problem to IBM” on page 112. 
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Symptom String Structure 


Symptom String Structure 


A symptom string is included in the dump for an abend, the dump for a program 
check, and the dump for a first failure support technology (FFST) probe point. 


Message IST931I is issued for abend messages, and messages beginning with 
EPW are issued for FFST. Both the IST and the EPW messages contain the 


symptom text string. 


Figure 17 shows an example of a symptom text string for an 


abend dump. For information about FFST symptom strings, see “FFST Console” 
on page 224. 


AB/S00C4 PIDS/5695-11701 


LVLS/201 LVLS/91.025 RIDS/ISTCFCWM 


RIDS/ISTAPCES#R RIDS/ISTCFCR2#L FLDS/PSW ADRS/000006C4 
VALU/HB0044770 FLDS/POWPSSQ ADRS/QO000F1C REGS/OC6A2 REGS/0A018 
VALU/HE0044770 PIDS/568508501 PTFS/0000000 PRCS/00000010 


Figure 17. Example of a Symptom Text String in Output 


The meanings of the fields are given below: 


AB 
ADRS 
DEVS 
FLDS 
LVLS 


MS 
OPCS 
OVS 
PCSS 
PIDS 
PRCS 
- PTFS 
REGS 
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Abend interrupt code, such as 0C4. 

Offset into the failing VTAM module. 

Device type and model related to the problem or generic device class. 
Fields, control blocks, and DSECTs labels. 


VTAM version and release level, or Julian date when the failing module 
was compiled. If LVLS appears twice in the symptom string, then it shows 
each of these values separately. 


Program or device message. 

Operation codes. 

Storage or core that was overlaid. 
Statements, commands, JCL. 

VTAM component ID. 

Return code, status code, condition, feedback. 
VTAM service level. 


The first two hexadecimal digits show the register number, and the next 
three hexadecimal digits show the displacement. The displacement value 
is the difference between the value of the PSW Instruction Address and the 
content of the register. Each REGS field is shown only if the value is less 
than the PSW, and if the difference is less than 4K. 


If the REGS field has a value of X'FFFFF', then no register contents are 
less than the value of the PSW Instruction Address and within 4K of the 
PSW Instruction Address. 


If the REGS field has a value of X'FEO00', then the value of the PSW 
Instruction Address is less than decimal 512. 
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RIDS One of three kinds of modules: 


e Recovery module, if followed by #R 
e Load module, if followed by #L . 
¢ CSECT name of the failing VTAM module, if not followed by anything. 


SIG = System or device issued operator warning signal. 
VALU Field value or overlay length. 
WS Wait state. 


Reporting the Problem to IBM 


For non-VTAM problems, call your IBM branch office. For suspected VTAM prob- 
lems, do either of the following steps: 


e If you have access to IBMLink, search for known problems in this area. If no 
applicable matches are found, report the problem to IBM by using the electronic 
technical report (ETR) option on IBMLink. | 


e Contact the IBM Support Center at 1-800-237-5511. 


After asking for your account name and other customer identification, the 
service representative will ask for a brief description of the problem. Your doc- 
umentation list should contain the answers to all questions related to the 
problem. 
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Chapter 3. Collecting Documentation for TSO/VTAM 
Problems (MVS) 


This chapter shows you what documentation to collect for each type of common 
problem with the TSO/VTAM program. Use this chapter in conjunction with 
Chapter 2, “Collecting Documentation for Specific Types of Problems” on page 57. 


Note: Most traces discussed in this chapter are described in Chapter 8, “Using 
Traces.” The exceptions are SVC 93 and SVC 94 entries. See Table 80 on 

page 1165 to determine what book describes the SVC 93 and SVC 94 entries. For 
VTAM and TSO/VTAM command syntax, see VTAM Operation. 


Initial TSO/VTAM Problem Analysis 
To use this chapter, start below and follow the steps. 
1. Are you receiving one or more of the following messages? 


e USS message 7 ‘LU-name UNABLE TO ESTABLISH SESSION — 
RU-name FAILED WITH SENSE sense’, or similar USS message 


e USS message 10 (the user-defined logon message) 
e Message IKTO29I or IKTO28! at the operator's console 


e Message IKJ608I at the operator's console. See Table 80 on page 1165 
to determine what book describes message IKJ608I. 


If so, go to “Logon Problems” on page 114. 
Otherwise, continue with step 2. 
2. Have you encountered one of the following abends? 


e ABENDOAB 
e ABENDOAC 
e ABENDOAD 
e ABEND15D. 


If so, go to “TSO/VTAM Abends” on page 117. 
Otherwise, continue with step 3. 
3. Do you have a hung terminal? 
e The terminal does not respond to any keys you press. 


e You must enter data from the terminal before processing will continue (in a 
situation where output is expected). 


If so, go to “Hung Terminal Problems” on page 119. 
Otherwise, continue with step 4. 


4. Are you having one or more of the following screen management prob- 
lems? | 


e Data is in the wrong place on the screen. 


e Data stream errors occur (such as operation checks, commands are 
rejected, PROGxxx). 
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e Function errors occur (such as incorrect full-screen processing or incorrect 
line prompting in input mode of TSO EDIT). 


¢ Data length is incorrect. 
e Data content is incorrect. 
If so, go to “Screen Management Problems” on page 121. 
Otherwise, continue with step 5. 
5. Are you having one or more of the following screen size problems? 
e The terminal does not operate in the expected screen size after log on. 
e The screen is not always the expected size during a TSO session. 
If so, go to “Screen Size Problems” on page 126. 
Otherwise, continue with step 6. 
6. Are you having one or more of the following performance problems? 
e Slow response time 
e An increase in the number of detected waits 
e An increase in the number of swap-outs. 
If so, go to “Performance Problems” on page 129. 
If your problem is not listed in the steps above, it is probably not a TSO/VTAM 
problem. Go back to Chapter 2, “Collecting Documentation for Specific Types of 


Problems” on page 57 and look for a more likely problem symptom. If you cannot 
find a more likely symptom, go to “Reporting the Problem to IBM” on page 112. 


Logon Problems 
This section provides documentation requirements and diagnosis procedures for 
logon problems. 
The recommended documentation is: 
e VTAM full buffer contents trace. 


To see the data in the buffer contents trace, set CONFTXT=NO in the 
TSOKEYO00O member of SYS1.PARMLIB before starting TSO/VTAM. 


e VTAM internal trace with MODE=EXT and OPTION=(API, MSG, NRM, PIU, 
SSCP, PSS). _ 


The VTAM internal trace may not be required. Review the diagnosis procedure 
for your problem to see if it is required. 


Note: API, MSG, NRM, PIU, and SSCP are always running internally. 
1. Did your first logon using USS commands fail? 

If so, continue with the next step. 

Otherwise, go to step 5 on page 115. 


2. Under “Unformatted System Services (USS) Tables” in the VTAM Resource 
Definition Reference, review the process for setting up the USS table and 
using USS commands. Check for the following errors: 
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e is your logon command syntax incorrect? 
If so, try to log on using the correct command syntax. 
Otherwise, continue with the next step. 

e is the logmode name incorrect? 


If the logmode name is specified incorrectly, or if a default logmode entry 
that is inappropriate for the device type is used, you will get USSMSG7. 
Look up the accompanying sense code in Chapter 15, “Sense Codes” in 
VTAM Messages and Codes and correct the logmode name. 


3. Can you log on to TSO without using USS commands? 
If you cannot log on at all, go to step 4. 


If you can log on, start the VTAM buffer contents trace and log on again. Look 
at the trace output to see what session parameters are contained in the BIND, 
and compare those parameters to the ones in your logmode table. 


If the session parameters in your logmode table are incorrect, make the neces- 
sary corrections. Also, make sure the DLOGMOD operand specifies the correct 
logmode table entry. (For more information on defining TSO/VTAM session 
parameters, see “Defining TSO/VTAM Session Parameters” in the VTAM 
Network Implementation Guide.) 


If you still cannot identify the problem, go to “Reporting the Problem to IBM” on 
page 112. 


4. Are you unable to log on at all? 


e If this is your first logon attempt from the device as well as your first logon 
attempt using USS commands, go to step 5. 


e If this is not your first logon attempt from the device, go to “Reporting the 
Problem to IBM” on page 112. 


5. Did your first logon from a particular device fail? 
If so, continue with the next step. 
Otherwise, go to step 7 on page 116. 


6. Check for an error in the terminal definition statement, the logmode table, 
or the MODEENT macro. 


(These are described in “TERMINAL” and “Logon Mode Table” in the VTAM 
Resource Definition Reference.) 


a. If you receive message IKT024I with return code X'210000' or X'220000', 
the BIND has been rejected. The following steps should help you find the 
portion of the BIND that is not valid: 


1) Locate the BINFM in the BIND. BINFM must be X'02' or X'03'. (For 
more information on coding the BIND, see “BIND Area Format and 
DSECT” in VTAM Programming.) 


2) If a PSERVIC is coded, see “PSERVIC” in the VTAM Resource Defi- 
nition Reference to make sure all fields are coded correctly. 


b. Check to see if the DLOGMOD name on the terminal definition statement is 
a valid logmode table entry. 
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If it does not match an entry in the logmode table, the first entry in the 
logmode table is used as the default. The parameters on the default 
logmode table entry may not be appropriate for your device type, and as a 
result, the wrong BIND image may be passed to the logon exit and a 
CLSDST PASS failure may occur. 


Note: You can see this failure in the VTAM internal trace using the API 
option. For more information on the VTAM internal trace, see Chapter 9, 
“Using the VTAM Internal Trace (VIT).” 


c. Check the logmode table entry to see if the parameters are specified cor- 
rectly for your device type. 


If not, the wrong BIND image may be passed to the logon exit and a 
CLSDST PASS failure may occur. 


d. Check to see if the MODEENT macro is defined correctly. 


If it is not, the terminal may reject the BIND, or the terminal may indicate to 
the logon exit that the terminal is not supported by TSO/VTAM. 


e. If you have not identified the problem, and if users can log on to TSO from 
other terminals, start the VTAM buffer contents trace and check the BIND. 


th 


. If logons fail for all terminals, or if the BIND in the buffer contents trace is 
what you expected, run the VTAM internal trace with options API, PIU, 
SSCP, and MSG. 


g. If you still have not resolved the problem, go to “Reporting the Problem to 
IBM” on page 112. 


. Did previous logons succeed, but now you cannot log on? 


If so, continue with the next step. 


. Did you get message IKJ608I? 


If not, go to step 12 on page 117. — 


If so, continue with the next step. 


. Is message IKJ608I followed by messages IST804I, IST4001, and IST805!1? 


If so, the CLSDST PASS or OPEN ACB may have failed. Continue with the 
next step. 


Is this a cross-domain logon? 
If not, go to step 11. 


If this is a cross-domain logon, you may have a VTAM definition problem. For 
more information on defining TSO/VTAM and logical units that must access 
TSO/VTAM in a cross-domain environment, see “Defining the TCAS Application 
to VTAM” in the VTAM Network Implementation Guide. 


Is there a TSO/VTAM APPLID that is not valid? (For more information on 
defining APPLIDs, see “Defining an Interpret Table for Compatible Logons” in 
the VITAM Network Implementation Guide.) 


If so, correct the APPLID. Once you have corrected the APPLID, you must 


_ deactivate the application and reactivate it to cause VTAM to reload the correct 
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12. Did you get message IKT1111? 
If not, go to step 13. 


If so, check the message text to determine the reason for the logon failure. 
See VTAM Messages and Codes for additional diagnostic information for partic- 
ular messages. 


13. Is an ABENDOAB with return code X'0105' or X'0203' associated with the 
logon attempt? 


If not, go to step 14. 


If so, check the LOGREC entry for the additional information shown in 
Table 10. | 


Table 10. ABENDOAB Information in LOGREC 


Reason 

Code Register Contents 

X'0105' 6 RPLRTNCD, RPLFDB2, and RPLDAF 
f RPLFDBK2 (the word of sense) 

X'0201 ' 8 ACBERFLG (for OPEN ACB failure) 
9, 10 TVWA ACB Name (TSOnnnn) 

X'0202 ' 8 ACBERFLG (for OPEN ACB failure) 
9, 10 TVWA ACB Name (TSOnnnn) 

X'0203' 5 ACBERFLG (for CLOSE ACB failure) 

—6«66, 7 TVWA ACB Name (TSOnnnn) 


Then go to “Reporting the Problem to IBM” on page 112. 


14. If none of the previous situations apply, start the VTAM buffer contents trace 
and the VTAM internal trace, and trace the logon attempt. Then go to 
“Reporting the Problem to IBM” on page 112. 


TSO/VTAM Abends 


ABENDOAB 


TSO/VTAM issues several unique abends. This section briefly describes the 
causes and documentation requirements for each one. Use the information pro- 
vided here and in Chapter 11, “Abend Codes (MVS) (VM)” in VIAM Messages and 
Codes to try to resolve the problem. If you are not able to do so, go to “Reporting 
the Problem to IBM” on page 112. 


ABENDOAB occurs when a VTIOC module issues a VTAM macroinstruction that 
fails. Depending on the values of the RPLRTNCD and RPLFDB2 fields, the macro 
may be retried. If the retry fails, ABENDOAB is issued. 


Table 11 (Page 1 of 2). ABENDOAB Information in a Dump of SDWA 


Length 
Offset (bytes) Description 
X'280' 8 Terminal name 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Chapter 3. Collecting Documentation for TSO/VTAM Problems (MVS) 117 


TSO/VTAM Abends “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Table 11 (Page 2 of 2). ABENDOAB Information in a Dump of SDWA 


Length 
Offset (bytes) Description 
X'289' 1 RPL request type: X'22' = SEND; X'23' = RECEIVE 
X'28A' 1 RPLRTNCD | 
X'28B' 1 RPLFDB2 
X'28C' 4 RPLFDBK2 (Sense code) 


If this happens during the execution of a SEND or RECEIVE, the session is placed 
in reconnect status. 
The recommended documentation is: 

e Contents of register 15. 


This contains the reason code, which is explained in Chapter 11, “Abend 
Codes (MVS) (VM)” in VTAM Messages and Codes. 


e Message text for message IKT116l. 
e The software LOGREC entry. 


If you have a LOGREC entry, look at an unformatted dump of the SDWA. 
Table 11 on page 117 describes the pertinent data you should look for in the 
dump. 


e The dump that is created automatically for this abend. 


For abends associated with I/O errors, a dump is not generated automatically 
unless the RCFBDUMP parameter of the TSOKEY00 member of 
SYS1.PARMLIB is set for it. 


e For errors that occur during session initialization or termination, run the VTAM 
internal trace with the options API, PIU, MSG, SSCP, and PSS. 


Note: The options API, MSG, PIU, and SSCP are always running internally, 
but you may want to run the VIT with MODE=EXT to be certain that you get the 
expected output. 


ABENDOAC 
ABENDOAC occurs when an error halts TCAS processing. 


The recommended documentation is: 
e Contents of register 15. 


This contains the reason code, which is explained in Chapter 11, “Abend 
Codes (MVS) (VM)” in VIAM Messages and Codes. 


e TWARSON (IKTCASWA + X'02'). 


This also contains a reason code. See Chapter 11, “Abend Codes (MVS) 
(VM)” in VTAM Messages and Codes, or see Table 80 on page 1165 to deter- 
mine what book contains the MVS system codes. 
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ABENDOAD 


ABEND15D 


ABENDOAD occurs when the TSO/VTAM queue manager has a problem manipu- 
lating storage for the input and output queues. 


The recommended documentation is: 


e Contents of register 15. 


This contains the reason code, which is explained in Chapter 11, “Abend 
Codes (MVS) (VM)” in VTAM Messages and Codes. 


e The dump that is created automatically for this abend. 


ABEND15D occurs when the issuer of a TGET, TPUT, or TPG macro passes a 
data area that is not valid to the SVC 93 modules. A TPUT or TPG request 
requires read access to the area, and a TGET requires write access. An 
ABENDOC4 occurs when IKTVTPUT or IKTVTGET tries to validate the data areas 
passed from the application program, and IKT93EST changes the ABENDOC4 to 
an ABEND15D. 


The recommended documentation is: 


e SLIP dump of the ABENDOC4. To determine what book describes the SLIP 
dump, see Table 80 on page 1165. 


e GIF trace of SVC 93 entries. 


Note: Either of these will show the address that is not valid. 


Hung Terminal Problems 


This section provides documentation requirements and diagnosis procedures for 
problems with hung terminals. Use this information if this problem occurs while you 
are using TSO/VTAM. This procedure helps you determine when the hang 
occurred and what was happening at that time. 


1. If the problem occurs during logon or logoff, get the recommended doc- 
umentation and go to “Reporting the Problem to IBM” on page 112. 


The recommended documentation is: 
e VTAM full buffer contents trace. 


To see the data in the buffer contents trace, set CONFTXT=NO in the 
TSOKEYO0O member of SYS1.PARMLIB before starting TSO/VTAM. 


e GIF trace of SVC 93 and SVC 94 entries. See Table 80 on page 1165 to 
determine what book describes the SVC 93 and SVC 94 entries. 


e TGET/TPUT trace. 


The TGET/TPUT trace creates trace entries for all TGET/TPUT/TPG data 
except address space ID TPUTs. 


You can get the TGET/TPUT trace by issuing the MODIFY TRACE 
command with TYPE=TSO. The MODIFY command is described in 
“MODIFY TRACE Command” in VTAM Operation. 


e Dump of the nucleus, CSA, and user's address space. 
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lf you think you might not be able to re-create the problem, take a dump 
before you try to clear the hang. 


If input (such as ATTN, RESET, or ENTER) clears the hang, both a dump 
and traces may be necessary. You may want to start the traces, take a 
dump with the terminal hung, clear the hang, and then stop the traces. 


e Collect additional general information: 


— Try to determine if the error is related to a certain type of hardware or a 
certain protocol (SNA or non-SNA). 


— Try to determine if the hang is related to a particular application 
program or type of application program (full-screen, graphics, and so 
on). 


If so, do other similar types of applications also hang? 


2. Was the last data that was sent from the application program to VTAM 
sent to the terminal before the hang occurred? 


To determine this, look for a VTAM buffer contents trace entry that corresponds 
to the last TPUT trace entry. 


If you see these corresponding entries, the output was sent to the terminal. 


3. If the keyboard locked after data was sent to the terminal, check the out- 
bound buffer contents trace entry for: 


e Bracketing indicators in RH byte 2 
e Change direction indicator in RH byte 2 


e Write control character to unlock the keyboard in byte 2 of the output 
request unit 


lf an end bracket was sent, the keyboard should be available. 


lf a change direction was sent and the keyboard has been unlocked, the key- 
board should be available. 


If a TGET is issued after a full-screen TPUT, TSO/VTAM should unlock the 
keyboard. 


4. If the keyboard has not been unlocked, see what kind of TPUT was issued 
last. (The option flag bytes in the TPUT entry show what kind of TPUT it is.) 


e For a NOEDIT or TPG TPUT, TSO/VTAM will not unlock the keyboard. 
The application program is supposed to send a write control character to 
unlock the keyboard. 


e For other TPUT options, is a TGET outstanding? 
lf a TGET is outstanding, TSO/VTAM should unlock the keyboard. 


lf no TGETs are outstanding, contact the group responsible for the applica- 
tion program. 


5. If the last activity prior to the hang was input from the terminal, was the 
data passed to the application program? (If it was, the TGET trace entry corre- 
sponds to the inbound VTAM buffer contents trace entry.) 


e If so, did the application program ever issue another TPUT? 
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If the application program never issued another TPUT, contact the group 
responsible for the application program. 


e If data has been received by TSO/VTAM, but it has not been sent to the 
terminal, go to “Reporting the Problem to IBM” on page 112. 


6. If you have not identified the problem, go to “Reporting the Problem to IBM” 
on page 112. 


Incorrect Output Problems 


Two main types of incorrect output problems are discussed in this section: “Screen 
Management Problems” and “Screen Size Problems” on page 126. Screen man- 
agement problems involve mode errors, exception responses, and problems with 
the data on the screen. Screen size problems involve an incorrect or unexpected 
screen size, either in a particular mode or all the time. Choose the one that is most 
like your symptoms, and follow the procedure for that problem. 


Screen Management Problems 


This section provides the documentation requirements and diagnostic procedures 
for problems displaying data on the screen. This section deals with five types of 
screen management problems: 


e Function error (incorrect screen management for mode). 
e Exception responses. 

e Extra or missing data. 

e Data is not placed correctly on the screen. 

e Data appears to be translated incorrectly. 


Choose the one that most closely matches your symptoms and follow the proce- 
dure for that problem. 


Note: Problems with incorrect screen sizes are addressed in “Screen Size 
Problems” on page 126. 
The recommended documentation is: 

e VTAM full buffer contents trace. 


To see the data in the buffer contents trace, set CONFTXT=NO in the 
TSOKEY00 member of SYS1.PARMLIB before starting TSO/VTAM. 


e GIF trace of SVC 93 and SVC 94 entries. See Table 80 on page 1165 to 
determine what book describes the SVC 93 and SVC 94 entries. 


e TGET/TPUT trace. 


The TGET/TPUT trace creates trace entries for all TGET/TPUT/TPG data 
except address space ID TPUTs. 


You can get the TGET/TPUT trace by issuing the MODIFY TRACE command 
with TYPE=TSO. The MODIFY command is described in “MODIFY TRACE 
Command” in VTAM Operation. 


e Dump of CSA storage and the user's address space. 
This is only required for address space ID TPUT errors. 


e May require a full PIU trace or CCW trace with data option. 
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Function Error 
If the screen does not function properly for the current mode of operation, do the 
following steps. 


1. Review the SVC 94 entries to determine the mode. The STFSMODE and 
STLINENO macros set full-screen mode on and off. 


e Full-screen mode. 
In full-screen mode, the application handles screen management. 


If the problem relates to full-screen processing, review the information on 
full-screen mode. See Table 80 on page 1165 to determine what book 
describes full-screen mode. If this does not describe the full-screen proc- 
essing that you are experiencing, note the differences. 


e Line mode. 
In line mode, TSO/VTAM handles screen management. 


In line mode, the data generated by the application program is placed line 
by line down the screen. READY appears on the line below the data, and 
the cursor appears on the line below that. When the screen is full, 
TSO/VTAM sends a page prompt to the screen. When you press the 
ENTER key, TSO/VTAM clears the screen and sends any remaining data 
to the screen. 


lf you enter data on the next to the last line of the screen, no page prompt 
is sent. Instead, TSO/VTAM clears the screen and reshows the data (or 
command) at the top of the screen. 


If this does not describe the line mode processing that you are experi- 
encing, note the differences. 


2. i fesse to the group (TSO/VTAM or the application program) that appears 
to be responsible for the incorrect screen management. 


e lf you have access to IBMLink, search for known problems in this area. If 
no applicable matches are found, report the problem to IBM by using the 
electronic technical report (ETR) option on IBMLink. 


e If you do not have access to IBMLink, call the IBM Support Center at 
1-800-237-5511. 


Exception Responses 
Follow these steps for exception responses. 


1. Does the error indicator reflect an error in the RU portion of the PIU 
(sense = 1003 or 1005)? 


If so, continue with this step. 
Otherwise, go to step 2 on page 123. 


a. See what kind of TPUT was issued. (This is shown in the flag byte of the 
TPUT trace entry.) 


b. For a NOEDIT TPUT, TSO/VTAM should not change the data provided by 
the application program. Compare the data in the TPUT trace, which starts 
at X'2C' into the trace record, with the VTAM buffer contents trace. 
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If TSO/VTAM has not changed the data, contact the group responsible for 
the application program that issued the TPUT. 


c. For a full-screen TPUT, was the data that is causing the error generated by 
the application program? (Data generated by the application program is 
present in the TPUT trace entry.) 


If so, contact the group responsible for the application program that issued 
the TPUT. 


If not, go to “Reporting the Problem to IBM” on page 112. 
2. Look at the error sense code. 


lf itis X'800A', the PIU is too long. This is probably a definition error. In this 
case: 


a. Look in the TH portion of the buffer contents trace entry to find out the 
length of the PIU that caused the error. 


b. See how MAXDATA is defined on the PCCU definition statement in the 
NCP definition deck. The MAXDATA value that you code should be as 
large as the largest PIU that is sent to the terminal by an application 
program. 


Note: If you increase the value of MAXDATA, this value should not 
exceed the product of the MAXBFRU and UNITSZ operands. See “HOST 
Definition Statement” in VTAM Network Implementation Guide for more 
information on defining the MAXDATA, MAXBFRU, and UNITSZ operands. 


If you have more than one PCCU definition statement, check to see that 
the right one is being used. 


3. If there are other error indicators, get the documentation shown in step 5 on 
page 98 and continue with that procedure. 


4. If you have not resolved the problem, go to “Reporting the Problem to IBM” 
on page 112. | 


Extra or Missing Data 
Follow these steps if you have an extra or missing data condition. 


1. Is the problem with input (data received by the application)? 
a. Is too much data being passed to the application? 


e If previous input is added to the end of the current input, the modified 
data tags may have been set improperly in previous TPUTs. Go to 
“Reporting the Problem to IBM” on page 112. 


e If the backspace key, character delete key, or line delete key is not 
functioning properly, look for SVC 94 entries that may have changed 
the default in the STCC macro. 


If this does not account for the problem, get a dump of the nucleus, the 
CSA, and the user's address space. Then go to “Reporting the 
Problem to IBM” on page 112. 


b. Is insufficient data being sent to the application program? 


e Find out which TGET option was used. TSO/VTAM edits data sent 
from the terminal before it passes it to the application program. The 
type of editing that TSO/VTAM does depends on the TGET option. 
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Certain characters may be deleted, such as control characters, aid 
characters, and set buffer address (SBA) sequences. Look at the flag 
bytes in the TGET trace entry to see which TGET option was specified. 
See Table 80 on page 1165 to determine what book describes TGET 
options. 


e Find out if any user edit exits are involved. User edit exits are listed in 
Chapter 4, “Writing TSO/VTAM Installation-Wide Exit Routines (MVS)” 
in VTAM Customization. 


e If you have not resolved the problem, go to “Reporting the Problem 
to IBM” on page 112. 


2. Is the problem with output (data sent by the application)? 
a. Was extra data sent to the screen? 


TSO/VTAM should not generate any printable data. Compare the data 
portion of the TGET/TPUT trace with the data in the VTAM buffer contents 
trace. 


If you see printable data in the buffer contents trace that is not in the 
TGET/TPUT trace, go to “Reporting the Problem to IBM” on page 112. 


If you see the same data in both traces, contact the group responsible for 
the application program that issued the TPUT. 


b. Was data from the application lost? 


TSO/VTAM does not generally delete data sent by the application program 
unless it is doing reshow processing. In reshow processing, TSO/VTAM 
deletes the full-screen TPUT and sends a reshow character (X'6E') to the 
full-screen application program. This is shown in the TGET trace entry. 
Compare the data portion of the TPUT trace entry with the data in the 
VTAM buffer contents trace entry to see if any data has been deleted. 
Determine whether this is a TSO/VTAM problem or an application program 
error and contact the appropriate group. 


See Table 80 on page 1165 to determine what book contains more infor- 
mation on reshow processing. 


3. If you have not resolved the problem, go to “Reporting the Problem to IBM” 
on page 112. 


Data Is Misplaced on the Screen or Page 
Follow these steps if data is misplaced on your screen or page. 


1. Does data wrap around the screen? (Wrapping means that data fills the line 
and splits inappropriately between lines.) 


lf it does, continue with this step. 
Otherwise, go to step 2 on page 125. 


a. Find out which TPUT option was issued. Bytes X'12' and X'13' of the 
TPUT trace entry contain the option flags. 


b. For a NOEDIT TPUT, TSO/VTAM does not edit data, and therefore does 
not change any SBA sequences that may be issued by the application 
program. Contact the group responsible for the application program that 

‘issued the TPUT. 
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c. For a full-screen TPUT, TSO/VTAM does not generate SBA sequences to 
place the data on the screen. 


If the symptom is incorrect screen size, go to “Screen Size Problems” on 
page 126. Otherwise, contact the group responsible for the application 
program that issued the TPUT. 


d. If the data was sent without a full-screen or NOEDIT option, go to 
“Reporting the Problem to IBM” on page 112. 


2. If the problem is not on a display terminal, go to “Reporting the Problem to 
IBM” on page 112. 


3. Are SBA sequences correct? Check the type of TPUT that was issued. 
Bytes X'12' and X'13' of the TPUT trace entry contain the option flags. For 
full-screen and NOEDIT TPUTs, the application program usually generates the 
SBA sequences that determine where data is placed on the screen. 


4. Is the buffer address incorrect? 


e If the buffer address is not valid for the screen size, contact the group 
responsible for the application program. 


e If the buffer address is valid for the terminal in its present screen size, go to 
“Reporting the Problem to IBM” on page 112. 


5. If this is the first non-full-screen TPUT following a full-screen TPUT, look 
for an SVC 94 trace entry for STLINENO. This macro may be issued by a 
full-screen application to indicate which line the next non-full-screen data 
should appear on. 


If the data was placed by the STLINENO macro, contact the support group for 
the application program that issued the macro. 


6. If you have not resolved the problem, go to “Reporting the Problem to IBM” 
on page 112. 


Data Appears To Be Translated Incorrectly 

Incorrect output is the main symptom of this problem. Sometimes the incorrect 
output is colons. The problem is probably related to the TPUT option that was 
specified. 


1. Look at the option flag bytes (X'12' and X'13') in the TPUT trace entry to 
determine what options were used. 


2. Determine what editing occurs for each type of TPUT option. See 
Table 80 on page 1165 to determine what book describes editing done by 
TPUT options. 


3. If the incorrect output consists of colons, determine what data from the 
TPUT trace entry is being edited into the printable character X'7A', a colon. 


4. See if TSO/VTAM is editing correctly. 


Note: Many applications use TPUT options that do extensive editing and 
translation. This allows many different hardware devices to communicate with 
the application program without causing I/O errors. You may need to write your 
own user edit exits to make sure that all characters that are valid for your termi- 
nals appear on the screen, especially if you are using type 1 logical unit 
devices. 
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5. If the editing does not appear to conform to the options specified, check 


for user edit exits or translation tables. (Chapter 4, “Writing TSO/VTAM | 
Installation-Wide Exit Routines (MVS)” in VTAM Customization has a list of 
these exits.) 


If you have exits or translation tables, verify that they are not causing the 
problem. 


. Did the application program send incorrect data to VTAM? The data is 


shown in the data portion of the TPUT trace entry. 


If so, the problem is in the application program. 


. If you have not resolved the problem, go to “Reporting the Problem to IBM” 


on page 112. 


Screen Size Problems 


This section provides documentation requirements and diagnostic procedures for 
screen size problems. Two major types of errors occur: 


The screen never operates in the expected size. 


The screen is not always the expected size when you change modes. 


Choose the one that most closely matches your symptoms and follow the proce- 
dure for that problem. 


Recommended documentation includes the following list. 


Note: All of the traces may not be required. Read the diagnostic procedure 
before you get them. 


VTAM buffer contents trace. 


To see the data in the buffer contents trace, set CONFTXT=NO in the 
TSOKEYO0O member of SYS1.PARMLIB before starting TSO/VTAM. 


GTF trace of SVC 93 and SVC 94 entries. See Table 80 on page 1165 to 
determine what book describes the SVC 93 and SVC 94 entries. 


TGET/TPUT trace. 


The TGET/TPUT trace records all TGET/TPUT/TPG data except address space 
ID TPUTs. 


You can get the TGET/TPUT trace by issuing the MODIFY TRACE command 
with TYPE=TSO. The MODIFY command is described in “MODIFY TRACE 
Command” in VTAM Operation. 


May require a full PIU trace or CCW trace with data option. 


Screen Is Never the Expected Size 
This is probably a definition problem. 


iF 


126  VTAM V4R2 Diagnosis 


If you are using a USS command to log on, try logging on without it. 


If this corrects the problem, review the use of the USS command in “Unfor- 
matted System Services (USS) Tables” in the VTAM Resource Definition Refer- 
ence and check the following: 


e Is the terminal a non-SNA 3270? 
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If it is, does the USS command include a USSPARM macro for the 
logmode? 


If so, VTAM ignores the logmode name from the terminal definition state- 
ments and uses its own default BIND image instead. 


e Does the USS command establish a default logmode name? 


If so, the default name overrides the name in the terminal definition state- 
ment. 


2. If this is not a USS command problem, check to see if the PSERVIC 
operand of the MODEENT macro is coded correctly. “PSERVIC” in the VTAM 
Resource Definition Reference explains how to do this. 


e Are primary and alternate sizes coded correctly? 
e For screen switching, is BINPRESZ coded correctly as X'7F'? 


3. If you have not identified the problem, look at the BIND that is sent. This is 
shown in a VTAM buffer contents trace of the logon. 


e If the BIND image is not what you expected, check the LU definition state- 
ment for an incorrect MODETAB or DLOGMOD parameter. 


e If no logmode table or DLOGMOD operand is specified, no PSERVIC is 
passed to the TSO/VTAM logon exit routine. In this case, TSO/VTAM 
issues an INQUIRE DEVCHAR macro and VTAM indicates that the ter- 
minal is a logical unit. TSO/VTAM then uses the SCRSIZE operand found 
in TSOKEYOO. The default value for SCRSIZE is 480 (12 rows and 40 
columns). 


4. If you have not resolved the problem, go to “Reporting the Problem to IBM” 
on page 112. 


The Screen Is Not the Expected Size for the Mode 

Full-screen mode. The application program controls screen management in full- 
screen mode. The primary (small) screen size is considered by TSO/VTAM as the 
default size. The application program can control screen size by sending write 
commands in TPUTs that it issues. The write commands are X'F5', erase write, 
and X'7E', erase write alternate. The application program issues X'F5', erase 
write, to set the primary screen size, or X'7E', erase write alternate, to set the 
alternate (large) screen size. 


If neither command is issued, the screen remains the size it is when the application 
program enters full-screen mode. 


Line mode. TSO/VTAM controls screen management in line mode. It generally 
uses the large (alternate) screen size when processing TPUTs in line mode. You 
can use the TSO TERMINAL command STSIZE macro during a session to change 
the screen size for non-full-screen processing. 


Using output from the VTAM full buffer contents trace, the TGET/TPUT trace for 
TSO/VTAM, and the GTF trace of the SVC 93 and SVC 94 entries, try to locate the 
source of the problem. 


1. Check the SVC 94 trace entries to see whether the processing is in full- 
screen mode or line mode. The STFSMODE and STLINENO macros set these 
modes on and off. | 
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If the processing is in line mode, go to step 6 on page 128. For full-screen 
mode, continue with step 2 on page 128. 


. Note if the incorrect screen size is related to entering or exiting full- 


screen mode. 


. Locate the TPUT trace entry for the data that appears on the screen when 


the screen is the wrong size. Determine the TPUT options for this TPUT and 
the one that precedes it by looking at the option flag bytes. 


lf either is a full-screen TPUT, look at the first data byte. 


lf the first data byte is an escape character (X'27'), the write command that 
follows has been specified by the application program. This write command 
should determine the screen size. 


If the write command is different in the buffer contents trace, go to “Reporting 
the Problem to IBM” on page 112. 


. If the first data byte is not an escape character, is a write command (X'F1', 


X'7E', or X'F5') provided? 
lf one of these write commands exists, continue with this step. 
If not, go to the next step. 


If this write command is different in the VTAM buffer contents trace, go to 
“Reporting the Problem to IBM” on page 112. 


lf the same write command appears in both traces, contact the group respon- 
sible for the application program. 


. If a write command is not provided in the TPUT data, and processing is in 


full-screen mode, does the write command generated by TSO/VTAM set the 
same screen size as the last write command provided by the full-screen appli- 
cation program? To determine this, compare the write command in the buffer 
contents trace entry with the last one provided in a TPUT trace entry. The 
write command is located in the data portion of the TPUT trace, at X'2C' into 


the entry. 


If the write commands are the same, go to “Reporting the Problem to IBM” on 
page 112. 


If the write commands are different, contact the group responsible for the appli- 
cation program. 


. If processing is not in full-screen mode, did the STSIZE macro set the 


screen size? To determine this, look in the SVC 94 trace entries. An entry 
code of X'0A' in the high order byte of register zero indicates that the STSIZE 
macro set the screen size. 


If the screen size was set by the application program, contact the group 
responsible for the application program. 


. If you have not resolved the problem, go to “Reporting the Problem to IBM" 


on page 112. 
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Performance Problems 


This section provides documentation requirements and diagnosis procedures for 
performance problems. Use this section along with the information in “Performance 
Problem” on page 101. In addition to the documentation required in “Performance 
Problem,” you will need a GTF trace of SVC 93 and SVC 94 entries. See Table 80 
on page 1165 to determine what book describes the SVC 93 and SVC 94 entries. 


1. Are wait and hold options slowing response time? 


The application program may be issuing TPUTs and TGETs with the wait or 
hold options. The wait option indicates that the application program should not 
regain control until output data has been placed on the output queue (TPUT) or 
input is available (TGET). A TPUT with a hold option indicates that control 
should not be returned to the application until the data has reached the ter- 
minal. These options may be necessary for screen management, but they 
prolong response time and increase the number of times the address space is 
swapped. 


2. Is an external system resource slowing response time? 


If all users must access the same resource, such as a system catalog, perform- 
ance deteriorates. This problem is especially severe when exclusive ENQs are 
used to control access to the resource. To improve performance, redistribute 
resources. 


3. Are high and low buffer extents set at inappropriate values? 


If the high and low buffer extents are too close together, output wait conditions 
occur. Buffer extents are specified in TSOKEYOO, a member of 
SYS1.PARMLIB. Tune the values of the high and low buffer extents to get 
optimum performance. Tuning is explained in Chapter 11, “Tuning VTAM for 
Your Environment” in the VTAM Network Implementation Guide. 


4. Are APPL definition statements coded correctly? 


Code the AUTH=NVPACE operand on all APPL definition statements for 
TSO/VTAM. 


If you do not set NVPACE, VTAM indicates that it has already received input 
data, instead of queuing the response until it receives the input data. Also, the 
swap count is incremented by two every time the ENTER key is pressed. 


5. Are pacing values set correctly for local SNA terminals? 


VTAM ignores the NVPACE operand for sessions with logical units in a local 
major node. Therefore, you must set non-zero pacing values for these logical 
units. 


6. Is the MVS performance group specified correctly? 


set the application program's performance group five to ten percent lower than 
VTAM's performance group. To see the application program's performance: 
group specification, look at the dispatching priority in the task's TCB. 


7. If you have not resolved the performance problem, go to “Performance 
Problem” on page 101. 
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Chapter 4. Collecting Documentation for VSCS Problems 
(VM) 


This chapter defines symptoms of VSCS problems, groups the symptoms into 
VSCS problem types, and gives step-by-step procedures for generating the appro- 
priate documentation to help resolve the problems. If you have to recreate a 
problem, follow the steps under the problem description that most closely matches 
your problem. 


Documentation You Should Collect for All VSCS Problems 


Always run VSCS with one or more trace options active. The more trace options 
that are running when a problem occurs, the easier it is for the VTAM change team 
to diagnose and correct a problem. The VSCS console communication services 
(CCS) trace option and the VTAM exit trace option default to ON. The CCS option 
traces data transferred, using IUCV, between VSCS and the CCS subcomponent of 
CP. The VTAM option traces activity in the VTAM services component of VSCS. 
The CCS and VTAM options do not significantly impact system performance. 


To prevent the VSCS global trace table from wrapping, run traces externally, 
increase the size of the global trace table, or use the VSCS ILU trace option. For 
information on setting the size of the VSCS global trace table, refer to the TRASIZE 
start option of the DTIGEN macroinstruction in Chapter 5, “VM/SNA Console 
Support (VSCS)” in the VTAM Resource Definition Reference. 


After you produce a VSCS dump, use a dump-formatting routine to format the 
dump output. Control blocks are easier to locate in formatted output. See “Dump 
Formatting Routine” on page 453 for information on formatting VSCS dump output. 


Have the following documentation available when you report a problem to the IBM 
Support Center: 


e VSCS link map (file VSCS LKEDIT on the VTAM RUN disk) 
e VSCS maintenance list (file with filetype VMFSVLOG on the VTAM RUN disk) 
e Console log(s) for the VTAM and VSCS virtual machines. 


“General Procedures to Diagnose Hung Logical Unit Problems” and “Determining 
Device Characteristics” on page 135 explain how you can use the VSCS DISPLAY 
|D=/uname command to determine the status of a particular logical unit. In some 
cases you can also determine where the problem is most likely to be, or which 
products are involved. 


_ General Procedures to Diagnose Hung Logical Unit Problems 


If the problem is for one or more logical units, but not for all logical units, use the 
following commands to determine additional information as to where the problem is, 
from an external viewpoint: 


1. Issue a VSCS DISPLAY |ID=netid./luname command. Use the display output to 
follow the steps below. 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 131 


Hung LU Problems 


132 VTAM V4R2 Diagnosis 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


a. If the logical unit is not found (message DTIS69I is issued), then VSCS has 
successfully closed the LU by issuing a VITAM CLSDST. The LU-LU 
session has ended. 


b. If VSCS can locate the logical unit, it displays message DTIS61I. This 
does not indicate that VSCS has an LU-LU session with the logical unit. If 
the logical unit has dialed another guest virtual machine using CP DIAL, 
“DIALED” is displayed. 


c. ls message DTIS66I displayed? If so: 
e Note the current presentation services (PS) state of the LU. 


If the current state is one of the following—CIP, CLF, IIP, INVL, LGF, 
LIP, PRG or SVR—then the logical unit is in an internal transitory state 
and is waiting for another process to complete before continuing. 
These states should be extremely short; if they are displayed by two or 
more DISPLAY commands, the logical unit is hung. 


If the current state is LUP, a VM logo should be displayed at the LU. 
No IUCV connection to the CCS subcomponent of CP exists in this 
state. 


If the current state is AWL, the VM screen indicating “PRESS ENTER 
TO CONTINUE” should be displayed at the logical unit. VSCS is 
waiting for an interrupt from the LU before it displays the VM logo (LUP 
state). No IUCV connection to the CCS subcomponent of CP exists in 
this state. 


If the current state is full-screen support mode (FSS), the logical unit is 
controlled by the application in the virtual machine to which it is logged 
on, or it has dialed a guest virtual machine using CP DIAL. In either 
case, the application is responsible for: 


— Sending the correct screens to the logical unit 


— Reading the data from the logical unit when the data becomes 
available 


— Restoring the logical unit's keyboard. 


Note: If the application does not restore the keyboard, logical units are 
left in a hung condition and cannot be reset. 


e Determine which response mode is active for this logical unit. 


— Exception response mode (ER) 
— Definite response mode (DR) 


Note: ER and DR refer to the mode that is allowed for this logical unit, 
not the mode requested for the current operation. Printer LUs always 
use DR mode. 


See the explanation of the SCHED= operand on the DTIGEN macroin- 

struction in Chapter 5, “VM/SNA Console Support (VSCS)” in the 

VTAM Resource Definition Reference for more information on exception 
response mode. 


e Determine whether SCIP recovery is in progress for this logical unit. 


SCIP indicates that a network failure occurred and that VSCS is 
attempting to reacquire the logical unit. 
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e Determine whether exception-response error recovery is in progress or 
pending for this logical unit. 


RP indicates that recovery is pending. VSCS is notified that an 
exception-response VTAM SEND has failed, but VSCS cannot initiate 
error recovery because the logical unit's RPL is busy. When VSCS 
receives the response, it will initiate recovery (exception response 
mode only). 


RIP indicates that recovery is in progress. When VSCS is notified that 
an exception-response VTAM SEND has failed, it initiates error 
recovery. 
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Error recovery includes the following steps: 
1) SEND of a CLEAR request 
2) SEND of a Start Data Traffic Request 


3) All PIUs are resent, starting with the one that failed first and pro- 
ceeding until all subsequent PIUs are sent. All PlUs are sent in 
definite response mode. When the last PIU is sent, error recovery 
is finished (exception response mode only). 


Determine the current VTAM services (VS) state of the logical unit. 


If the current state is TERM, then VSCS is attempting to terminate the 
logical unit. 


If the current state is NORM, then the logical unit has not been termi- 
nated. 


d. Is message DTIS65I displayed? If so: 
e Does this message contain any IUCV PATHIDs? 


If so, an IUCV connection to the CCS subcomponent of CP is active. 
Two PATHIDs should be displayed. The first is the IUCV PATHID that 
VSCS uses for its IUCV requests to CCS. VSCS receives this PATHID 
when an IUCVCOM CONNECT GCS macroinstruction executes for the 
logical unit. The second is the IUCV PATHID that CCS uses for its 
IUCV requests to VSCS. VSCS receives the PATHID from CCS during 
the logical unit's CCS initialization. If only one PATHID is displayed, it 
is the first; VSCS has not received CCS's PATHID for this logical unit. 
This indicates a problem with CP. 


If this message just contains blanks, then a CP connection is not cur- 
rently active. 


What is the current RPL command? 
Is the RPL currently busy? 


If so, VSCS is waiting fora VTAM RPL command to complete before 
doing anything else on the logical unit's behalf. Several conditions can 
cause this to occur, including: 


Missing I/O interrupt 

Blocked PAB in VTAM 

Network problem with the device or routes 
— SIO never issued. 


Issue the VTAM D NET,ROUTES TEST=YES to determine if the route 
is intact. If it is intact, you need VTAM buffer use and line traces to 
determine whether the device responded to the last request. 


e. Is message DTIS591 displayed? 


Note: This message is displayed only if the RECEIVE SPECIFIC option is 
active. 


If so, then is the RECEIVE SPECIFIC RPL busy? 


If it is not busy, then VSCS cannot receive any input from the logical unit. 
Normally, this occurs only when the device is being returned to VTAM, is 
recovering from an error, or is processing input data for the logical unit. 
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If the current PS state is AWL, the logical unit may be hung. The AWL 
state indicates that VSCS is waiting for an interrupt from the logical unit 
before displaying the VM logo. If the keyboard is currently locked, then 
VSCS cannot receive the interrupt, and the logical unit is hung. 


—h 


. Is message DTIS68I displayed? 


If so, then are the SEND or RECEIVE counts incrementing for the logical 
unit, or are both currently zero? 


If both are zero, you need additional information to determine whether the 
problem is in VSCS or VTAM. For example: 


1) If the problem occurred during logon, determine whether the device 
characteristics are correct for this logical unit. Check message 
DTIS65I. If the current RPL command is OPNDST and the RPL is 
busy, determine why VTAM is not completing the request. 


2) If SCIP is included with message DTIS66I, determine why recovery of 
the logical unit is not completing. 


3) If the current RPL command in message DTIS65I is CLSDST, and the 
RPL is busy, determine why VTAM is not completing the request. 


2. If the device is a printer or the device was doing a copy function when it hung, 
issue the VSCS DISPLAY PRTTAB command. This shows all active printers 
defined to VSCS and the current status, which includes any associated display 
using a printer. 


Additional information can be obtained about each device by using the VSCS 
DISPLAY ID= command for each logical unit in the printer table. This 
command provides more detail about the status of each logical unit associated 
with a printer copy function. 


Determining Device Characteristics 


To determine if the right VTAM logmode entry was used, issue the VSCS DISPLAY 
ID=netid.luname command. The resulting messages indicate how the device char- 
acteristics appear to VSCS. 


1. Is message DTIS61I displayed? 
If so, note the device type: 3277, 3278, 3767, 2741, TWX, or PRT. 


Specifying the wrong VTAM logmode entry, or using the VTAM default logmode 
entry, leads to incorrect operation of the logical unit. In some cases, DTIPIPUT 
issues message DTIP27I| or message DTIS991 when input is received from the 
logical unit. 


Also note the device model. This determines the screen size that is used for 
display devices. (Screen size is displayed in message DTIS63I.) 


2. Ils message DTIS62! displayed? 
If so, what is the logical unit type? 


0 Non-SNA display or printer device 
1 Keyboard/printer device 

2 SNA display 

3 SNA printer device. 
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What are the device characteristics? 


e EDS indicates that extended data stream commands are supported (for 
example, use of the Write Structured Field commands). Non-SNA devices, 
for example, BSC and start-stop devices, must have FEATUR2=(EDATS) 
specified in the NCP definitions if the capability exists. 


Note: EDS is not supported for a non-SNA device connected through an 
integrated communication adapter (ICA). 


e NEDS indicates that extended data stream commands are not supported. 


e The APL NEWIOLD field indicates whether the device uses the NEW or 
OLD APL character set. 


e COLOR indicates the device supports color. If the device does not support 
color, this field is blank. 


e SHARED indicates that the device is a shared printer. If the device is nota 
shared device, this field is blank. 


3. Is message DTIS63! displayed? 


Note: This message is issued for display terminals only. 
If so, note the screen size from the PSERVIC field of the VTAM logmode. 


Also note the alternate screen size from the PSERVIC field of the VTAM 
logmode (or, for some devices, from the Write Structured Field Query reply 
data). 


. Ils message DTIS641 displayed? 


Note: This message is issued for keyboard/printers only. 


. If the device is a printer, use the VSCS DISPLAY PRTTAB command to show 


whether the printer was defined or acquired by VSCS and to determine its 
current status. 


Determining VSCS Module Levels 


A variety of problems can occur if the VSCS modules are not all at the correct 
level. This means that each module must be for the same release and if mainte- 
nance has been applied, all modules affected by the maintenance must be present. 


To determine the module levels, take the following steps: 


1. 


Obtain a machine readable dump of VSCS. Use the #CP VMDUMP 0:END 
DSS FORMAT GCS command, the GCS GDUMP 0- FORMAT GCS command 
or use an existing dump of VSCS. 


. Start PRTDUMP, and answer “Y” when you are asked if you want to format 


VTAM control blocks. When you are asked if you want to format VSCS control 
blocks, also answer “Y” to access the VSCS formatting options. 


. Select option 5, “VSCS module cross-reference.” This produces two listings of 


VSCS modules, one sorted by module name and one sorted by module 
address. , 


4. Select option Q “Quit” when the previous option completes. 


5. Obtain the printed output just created. 
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The resulting output looks similar to the condensed version in Figure 18 on 
page 137. 
VSCS DUMP FORMATTING OUTPUT PAGE 02 


SORTED BY MODULE NAME 


ADDRESS NAME DATE  PTF/APAR ADDRESS NAME DATE PTF/APAR ADDRESS NAME DATE PTF/APAR 
019E4410 DTICEXIT 93.321 O@1ABCAA8 DTICGMSG 93.321 Q1AQA288 DTICINIT 94.300 
@19FOC58 DTICIUCV 94.216 O1AODA9FO DTICLOGO 93.321 01905728 DTICTERM 93.321 
Q1A00266 ODTIIQUIT 93.321 019D76A8 DTIISDA1 93.321 Q1A1D928 DTIISDA2 93.321 
VSCS DUMP FORMATTING OUTPUT PAGE 05 


SORTED BY ADDRESS 


ADDRESS NAME DATE  PTF/APAR ADDRESS NAME DATE PTF/APAR ADDRESS NAME DATE PTF/APAR 
81403420 DTISLCMD 93.321 019D4000 DTIISTRT 94.266 01905538 DTIITERM 93.321 
81905728 DTICTERM 93.321 919D5A18 DTIUSERO 00000. 819D5E40 DTIPRTRT 94.216 
019D76A8 DTIISDA1 93.321 Q019DF318 DTIPOWRT 94.299 01960510 DTIPRFLD 93.321 


Figure 18. Module Cross-Reference in a VSCS Dump 


The date field contains a Julian date (YY.DDD), which is: 


e Two-character year (YY) 
e Period 
 Three-character day (DDD). 


The exceptions to this format are: 


1. DTIPARM and DTIUSERO-DTIUSERS, which use the form of YYDDD, period 
at the end. The DTIUSERx field can contain just about anything if the DTIGEN 
parameter IDENT is supplied. See Chapter 5, “VM/SNA Console Support 
(VSCS)” in the VTAM Resource Definition Reference for more information on 
the DTIGEN macroinstruction. 


2. DTISMSGM, which does not contain a date. 


3. The data manipulation exit routines DTIPDDSI, DTIPDDSO, DTIPDNTI and 
DTIPDNTO may not be listed if user coding conventions are not similar to the 
VSCS conventions. 


If maintenance has been applied, the PTF/APAR field is filled in with the informa- 
tion found in the module. Otherwise, the field is left blank. For example, in 
Figure 18, UV12345 has been applied to DTICEXIT, and DTICGMSG is at base 
level. 


With this list you can now determine the following information about the VSCS 
modules: 

e Base level of all modules by date. 

e Current maintenance level of each module found. 


e Whether user-provided start options are being used (indicated by the presence 
of module name DTIUSERx). 


e Whether user-provided data manipulation exits are present (indicated by using 
the date, which will be greater than the base, missing, or not valid). The data 
manipulation exits are: 


— DTIPDDS!I 
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— DTIPDDSO 
— DTIPDNTI 
— DTIPDNTO. 


e Where a particular module resides in storage, shown by the address in the first 
column to the left of the module name. 


Determining the Status of a VSCS Printer LU 


To determine the status of any VSCS printer, there are two VSCS commands avail- 
able: 


e VSCS DISPLAY PRTTAB, which shows the status of all printers that currently 
reside in the printer table, whether or not the printer is in session with VSCS 


e VSCS DISPLAY |ID=netid.printername, which displays the detailed status of a 
printer LU that is currently in session with VSCS. 


Each command has its advantages, but the DISPLAY PRTTAB provides more of a 
general look at the printer status. From the output of the DISPLAY PRTTAB 
command, you can determine: 


How many printers can be defined 

How many printers are defined 

lf printer sharing is supported 

How a printer was defined to VSCS 

If a printer is in use 

Which display LU is currently using a printer 

If a printer is currently being acquired 

lf a printer is currently in session with VSCS 

lf a request to release the printer has been received 

If a printer has been forced using the VSCS FORCE command. 


The following figure explains some of the potential conditions that are displayed in 
the VSCS DISPLAY PRTTAB command output. 
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Copy requested and display is still 
waiting for the printer to be 
acquired. 


Copy requested and display has been 
released because the printer could 
not be acquired within the 

specified time (TIMECPY=). 


Copy requested and the display is 
waiting for the printer to be 
acquired. However, a request to 
release the printer has been 
received. 


Copy requested and the display is 
waiting for the printer to be 
acquired. However, a VSCS FORCE 
command has been issued for the 
printer. 


This printer was attached to VSCS 
with the VTAM VARY command and is 
currently not in use. 


Figure 19. DISPLAY PRTTAB Command Output Conditions 


When more specific information is needed for a printer that is in session with 
VSCS, use DISPLAY !D=netid.printername. The output from the DISPLAY ID= 
command allows you to determine: 


LU characteristics 
SEND/RECEIVE counts 

Time the LU logged on to VSCS 
LU states. : 


Operational Differences between VSCS and CP 


VSCS strives for total compatibility with native CP-controlled terminals, but that 
cannot be achieved for several reasons. Some of the reasons are: 


e SNA versus non-SNA device differences 
e Performance implications 

e Interface restrictions 

e Interface timing 

e Operating inconsistencies 

e Operational requirements. 


These reasons for not achieving total compatibility result in the following VSCS 
restrictions. 
e General 


— Protocol converters and OEM devices must react identically to IBM devices 
in all situations to obtain the desired results. 
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— The proper VTAM logmode must be used when logging on to VSCS. See 
“Logon Mode Table” in the VTAM Resource Definition Reference for addi- 
tional information on the logmode requirements for VSCS LUs. 


e Display terminals 


— A VSCS LU should never log on as the operator console for VSCS, VTAM, 
or CP. This can cause major problems if the LU goes into CP mode. 


— Logon from logo: 
- Only supported if the command lines are provided to VSCS. 


- VM logo command lines must contain three fields: USERID, PASS- 
WORD, and COMMAND. 


- The Insert Cursor must be located at the first available position of the 
USERID field. 


- Password mask must be in the PASSWORD field provided. 
— VMEXIT cannot be used as a valid user ID from a VSCS LU. 


— Color and highlighting changes to the input and status area are reflected 
more often on SNA LUs. 


— When issuing a message to yourself, the input is shown in the redisplay 
color and the incoming message is shown in the CP color. On a native 
device, only the redisplay color is used. 


— Stacked input data is redisplayed exactly as entered, not separated by 
command as on native devices. 


— Fora PF key defined “CP SET PFnn TAB n1 n2 ...,” VSCS inserts blanks 
and native CP inserts null characters. This may cause the results to look 
different. 


— Input data is redisplayed in the case entered. 


— Full-screen applications are expected to retrieve data when notified that 
input has been received by VSCS. 


— Full-screen applications are expected to reset the keyboard, in order to 
allow the LU to enter additional data. 


On logical unit type 2 devices (SNA displays), VSCS converts the SIGNAL 
Request-to-Send RU that is generated by the ATTN key into a PA1 key. 
The ATTN key functions regardless of the session state of the LU-LU 
session with VSCS. That is, the ATTN key functions even when the status 
indicators on the display show “X SYSTEM” or “X CLOCK.” When these 
indicators are displayed, the keyboard is locked. The ATTN and SYS REQ 
keys are the only keys that function in these states. 


e Keyboard/printer devices 


— The DIAL command is not supported. 
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Symptoms of VSCS Problems 
This chapter divides VSCS problems into the following general problem types. 


Note: Documentation requirements may differ if VSCS is running in a separate 
virtual machine from VTAM. It is also important to understand that VSCS errors do 
not always result in a message, user disconnection, or user logoff. 


e “Initialization Problems” on page 143 


— Initialization never completes 

— VSCS terminates immediately upon starting 
— Loop occurs during initialization 

— Other initialization problems. 


e “Termination Problems” on page 150 


— Termination never completes 

— VSCS terminates prematurely 

User’s session terminates prematurely 

Operator commands terminate VSCS unexpectedly 
— Other termination problems. 


e “Logon Problems” on page 157 


— First logon attempt fails 
— Logon never completes (logical unit is hung). 


e “Logoff and Disconnect Problems” on page 159 
e “Wait and Loop Problems” on page 159 


— All VSCS logical units are hung 
— One or more VSCS logical units are hung. 


e “Message Problems: Message DTIS99I Indicates a VSCS Internal Error’ on 
page 176 


— Message DTIS99I indicates an internal error. 
e “Incorrect Output Problems” on page 178 
e “Performance Problems” on page 182 


— Paging and storage problems 
— Slow response time on terminals. 


e “Other VSCS Problems” on page 183 


— SNA dial problems 
— Printer sharing problems 
— Operator command is not processed properly. 


Overview of Normal VSCS Initialization Process 


This section contains an overview of what takes place during normal VSCS initial- 
ization. This is the procedure that VSCS follows each time it is initialized. 
Figure 20 on page 142 shows the components involved in initialization. 


GCS processes IUCV requests from VSCS that affect path ID setup and break- 
down. IUCV external interrupts are handled by GCS, which gives control to VSCS 
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after some validation is done. All other IUCV requests and responses issued by 
VSCS are handled directly by CP. 


VSCS and VTAM 


Figure 20. Components Involved in VSCS Initialization 


1. VSCS storage is initialized with DTIUSER«x, if specified. 
2. VSCS issues message DTICO1I. 
3. VSCS issues IUCVINI SET to GCS. 
GCS sets return code after processing request. 
4. VSCS issues IUCV QUERY to CP. 
CP responds with MAXCONN and EIB size. 
5. If VSCS trace is active, message DTIS74I is issued. 
6. VSCS issues global IUCVCOM CONNECT and if successful: 


e CP provides path ID and a return code back to GCS 

GCS passes path ID and a return code back to VSCS 

VSCS issues a system WAIT at this point 

CP generates an external interrupt for “CONNECT COMPLETE” 
GCS passes “CONNECT COMPLETE” back to VSCS 

CP generates an external interrupt for VM logos 

GCS notifies VSCS of a pending message. 


7. VSCS issues IUCV RECEIVE 


e VSCS processes “CONNECT COMPLETE” 
e CP sends VM logo data to VSCS. 


8. VSCS processes VM logo information. 
9. VSCS issues message DTICO2I. 
10. VSCS attaches the utility services subtask to GCS. 
11. VSCS issues VTAM OPEN ACB through GCS to VTAM. 


12. VSCS schedules a work element containing the VTAM user ID to presentation 
services. 


13. VSCS issues message DTIVO04I. 
14. VTAM interface should be functional; VSCS is fully functional. 
15. VSCS issues an IUCV SEND to supply CP with the VSCS user ID. 
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Initialization Problems 
First you should look for initialization problems in these areas: 


1. A storage shortage could occur if: 


e VSCS is in the same virtual machine as VTAM in a large environment 
e VSCS is in a small virtual machine 
e VSCS DTIGEN parameters are incorrect: 
— Trace table is too large for virtual machine size 
— Printer table is too large for virtual machine size 
— Block multiplier (BLKMULT) is too large for virtual machine size. 
e Specified size for MAXCONN is too large. MAXCONN is a parameter in 
the directory entry for the user ID running VSCS. 


2. Parameters are misspelled or missing; VSCS initialization uses most of the user 
parameters coded for: 


e CP 

e GCS 

e VTAM APPL definition 

e DTIUSERx (if specified) 

e VM directory entry for the VSCS virtual machine. 


3. The wrong disk is linked to the VSCS load module. 


4. The disk containing the VSCS load module has changed since it was last 
accessed by this virtual machine. 


5. The VTAM application program major node is inactive or is not valid. 


6. The VM directory is incorrect (the user ID for the IUCV option card must be 
“CCS’). 


lf none of the previous items is causing the problem, follow the procedure for your 
symptom: | 


“Initialization Never Completes (A Wait Follows Message DTICO1I or DTIS74l)” 
“VSCS Terminates Immediately upon Starting” on page 145 

“A Loop Occurs during Initialization” on page 148 

“Other Initialization Problems” on page 149. 


Initialization Never Completes (A Wait Follows Message DTICO1I or 
DTIS741) 
1. Is SNA enabled? 


A delay during initialization is normal; VSCS must wait for external interrupts for 
“CONNECT COMPLETE?” and the VM logo. A long wait indicates a problem. 
ENABLE SNA is used to open a path from IUCV to CCS, and if SNA is disa- 
bled, CCS does not process the connection request. 


Note: If SNA is disabled and VSCS started, it may appear that most operator 
commands do not complete. 


To make sure that SNA has been enabled, use one of these CP commands: 
#CP ENABLE SNA 
#CP ENABLE ALL 
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#CP ENABLE SNA user ID 


To determine what book describes CP commands for your operating system, 
see Table 80 on page 1165. 


2. Are GCS and the VTAM recovery machine active? 


Issue the GCS command QUERY GROUP to see if GCS is active. If you get 
the message “HCPOO45E GROUP not logged on” or “MKO45E GROUP not 
logged on,” GCS is not active. You must re-ip| GCS using the CP IPL GCS 
command. Use the CP QUERY NAMES command to see if the VTAM 
recovery machine is active. If it is not active, you need to initialize it. 


3. Does GCS have control register 0 bit 30 on? 


To determine if control register 0 bit 30 is set on, display the control registers 
from the VSCS operator console (DISPLAY X'0O') or look in a dump of the 
VSCS virtual machine (all registers are shown at the beginning of the dump). 
GCS must set the control register during GCS initialization in order to receive 
IUCV external interrupts from CP. If control register 0 bit 30 is off, verify that 
the VSCS directory entry is correct (or the VTAM directory entry, if VSCS will 
run in the same virtual machine as VTAM). Continue problem resolution with 
GCS. 


4. Did CP process the IUCV CONNECT request without error? (“Without error’ 
means that no error messages were issued by CP, GCS, or VSCS.) 


If so, continue with step 5. If not, the problem is in CP or GCS. 


This is shown in the CP internal trace entries hex 15 (IUCV) and hex 16 (CCS) 
in the CP internal trace table. Before starting VSCS, limit the amount of the 
external trace generated by issuing SET CPTRACE or TRSOURCE. | 


To determine what book describes the CP trace for your operating system, see 
Table 80 on page 1165. | 


5. Did GCS reflect the external interrupts (for “CONNECT COMPLETE?” and the 
VM logo) to VSCS? 


To determine this, look at: 


e CP internal trace of IUCV and CCS requests 
e GCS external trace of external interrupts received 
e VSCS trace with CCS active. 


lf GCS did not reflect the external interrupts to VSCS, the problem is in GCS. 


If all of these conditions are met, the IUCV will be properly initialized and you 
will see message DTICO2I. 


To determine what book describes IUCV, CCS, and GCS commands for your 
operating system, see Table 80 on page 1165. 


6. Was VSCS previously active, and now cannot be restarted? 


If this is the case, the problem may arise from an abend or premature termi- 
nation (message DTICO71) of VSCS during the previous VSCS initialization 
(assuming CP has not been reinitialized since then). If CP and GCS did not 
clean up after the abend, VSCS cannot restart. Check the operator console 
listing to see if any problems were encountered on the previous termination. If 
there were problems, re-IPL GCS. If initialization still fails, re-IPL CP. 
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7. lf you do not have enough information, or cannot solve the problem, re-create 
the problem with the GCS, CP, and VSCS traces active externally. Use your 
best judgment in trying to decide which product has the problem. If you 
suspect GCS or VSCS is causing the problem, get a VSCS dump. Otherwise, 
pursue the problem with CP. 


To determine what book describes CP commands for your operating system, 
see Table 80 on page 1165. 


8. Go to “Reporting the Problem to IBM” on page 112. 


VSCS Terminates Immediately upon Starting 


1. How far did initialization go? 


Get the operator console listing, and use “Overview of Normal VSCS Initializa- 
tion Process” on page 141 to evaluate the console messages to see how far 
the initialization progressed. VSCS messages that occur during successful 
initialization are DTICO1I, DTICO2!, and DTIVO4I, in that order. 


Note: Messages issued for starting the VSCS internal trace are not included 
here. 


If you did not get DTICO1I, the problem may be: 
© GCS is not active. | 
e VSCS is not linked correctly. 


e VSCS virtual machine is not large enough to hold the DTIISTRT load 
module. 


e DTIGEN parameters are incorrect. 
e GCS is dumping the VSCS virtual machine. 

lf you receive DTICO1I but not DTICO2I, the problem may be: 
e VM directory entry for the VSCS virtual machine is wrong. 
¢ GCS is dumping the VSCS virtual machine. 


e CP or GCS found a problem (other than an abend) while processing an 
IUCV request or response. VSCS should issue a message to identify the 
failure and reason. See step 2 on page 146. 


If you receive DTICO1! and DTICO2I, but not DTIVO4I, the problem may be one 
of the following: 


e If you receive message DTIC14I, then errors were encountered processing ~ 
the VM logo. The errors can be: 


— ABORT - Bad VM logo data received. 
— STOR - Storage could not be obtained for the VM logo. 


e VTAM OPEN ACE error. (VTAM return codes show what caused this.) 
e VTAM APPL definition is incorrect. 

e VTAM APPL definition is not active. 

e VTAM storage shortage. 

e VSCS storage shortage. 
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e VSCS DTIUSERx problem, such as incorrect parameters. (See “Other 
Initialization Problems” on page 149.) 


¢ GCS is dumping the VSCS virtual machine. 


If you receive DTIV18I, you must issue the SYSTEM RESET command or use 
the CP FORCE command to stop and autolog the GCS recovery machine to 
initialize VSCS. 


. Was an error message issued? 


If so, try to find the source of the message. If not, go to step 5 on page 147. 


e CP messages begin with HCP 

e GCS messages begin with GCT 
e CMS messages begin with DMS 
e VSCS messages begin with DTI 
e VTAM messages begin with IST. 


If GCS issued the message, and it is not an abend, get a VSCS dump. See 
“VSCS Dump” on page 453 for more information on the VSCS dump. Then go 


_ to “Reporting the Problem to IBM” on page 112. 


. Did you get an error message with a return code or IPTYPE? 


If so, find the explanation for it, and determine what component issued the 
message. If not, go to step 4 on page 147. 


Table 12 shows the sources of return codes and IPTYPEs. 


Table 12. Source of IPTYPE or Return Code During Initialization 


Message Source of IPTYPE or Return Code 
DTICxxx e GCS 

e VM 

e VSCS (very rarely) 
DTIIxxx ¢ GCS 

e VSCS 
DTIPxxx e VM 

e VSCS (very rarely) 
DTISxxx ¢ GCS 

e VSCS 
DTIVxxx e GCS 

e VSCS 

e VTAM 
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e If you receive message DTICOS5I with return code 878 or 804, then GCS 
had a GETMAIN failure getting storage for an IUCV request. See “Storage- 
Related Problems” on page 179 for more information. 


e lf you receive message DTICO7I with IPTYPE=03, the previous termination 
did not complete, or two IUCV CONNECTs with the same name have been 
issued from the same GCS group. IPTYPE=03 is an IUCV SEVER request 
from CP, indicating CP is rejecting the connection request. 


If you can re-create the problem, follow these steps: 


a. Use the DTIGEN operands to activate VSCS internal trace options, 
including the external trace option. See Chapter 5, “VM/SNA Console 
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Support (VSCS)” in the VTAM Resource Definition Reference for infor- 
mation on specifying VSCS trace options in the DTIGEN. 


. Initiate TRSOURCE. 
. Start VSCS using the newly created DTIUSER«x. 
. After the failure occurs, stop TRSOURCE. 


. Process the output, which should contain the failing sequence. See 
“Collecting External Trace Data (VM)” on page 359 for information on 
using operating system utilities to collect, format, and print VSCS trace 
output. 


o Aa a F&F 


e If you receive message DTICO9I, you should determine which component 
generated the return code. To determine what book describes the IUCV 
connect return codes for your operating system, see Table 80 on 
page 1165. 


e If you receive an error message not yet mentioned, look in the system pro- 
grammer's guide for your operating system to interpret the meaning of the 
return code. To determine what book describes the IUCV connect return 
codes for your operating system, see Table 80 on page 1165. 


If the message has an IPTYPE, the IPTYPE is one of the following: 


Pending connection 
Connection complete 
Severed connection 
Quiesced condition 
Resumed connection 
Incoming priority reply 
Incoming reply 

Incoming priority message 
9 Incoming message. 


ONO Of WD — 


4. Did you get an error message without a return code or IPTYPE? 


If so, does the message text adequately explain the problem? If you can fix 
the problem by correcting user-specified parameters, do so. If not, get the VM 
directory entry for the VSCS virtual machine, VSCS installation information, and 
GCS specified parameters. Then go to “Reporting the Problem to IBM” on 
page 112. 


Note: Figure 21 on page. 148 shows all the VSCS messages that can be 
issued for an initialization problem. 


5. ls the problem an abend? 


If an abend occurs during initialization, the problem is most likely caused by an 
error in the installation process of VSCS. Find out how VSCS was installed 
and linked. 


An ABENDOC2 might also occur if one of the following is true: 


e VSCS is not running in an authorized virtual machine. 
e The VSCS APPL definition does not specify AUTHEXIT=YES. 


An ABENDOC1 might also occur if one of the following is true: 


e The VSCS APPL definition does not specify AUTHEXIT=YES. 
e The VTAM DCSS is too small to contain all of ISTO0019C1. 
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If an ABEND706 is received before any VSCS messages are displayed, then 
there was a failure linking the VSCS load module. That failure left the load 
module “non-executable.” 


Otherwise, if the failure results from a link failure with a DTIUSERn load 
module, message DTII111 is issued. 


If you cannot find and correct the error, get a VSCS dump (created automat- 
ically for an abend) and go to “Reporting the Problem to IBM” on page 112. 


6. Is the problem something else? 


If you still cannot identify the problem, get a VSCS dump and go to “Reporting 
the Problem to IBM” on page 112. The VSCS dump is described in “VSCS 
Dump” on page 453. 


DTICO3! 


DTICO4I 
DTICOS5I 
DTICO6I 
DTICO7I 
DTICO9I 


DTIC141 
DTIIO3I 
DTII041 
DTIIO6I 
DTI141 
DTII15! 
DTII16I 
DTIP151 


DTIS38I 
DTIS99I 


DTIVO1l 
DTIVO7I 
DTIV18I 


modname VSCS INITIALIZATION FAILED—INSUFFICIENT STORAGE AVAILABLE 


Note: The virtual machine is too small to initialize VSCS or the DTIGEN operands are coded incorrectly. 


modname VSCS INITIALIZATION FAILED—UNRECOVERABLE ERROR DETECTED description 
modname VSCS INITIALIZATION FAILED—IUCVINI SET MACRO FAILED WITH RETURN CODE nn 
modname VSCS SEND OF VTAM USERID TO CCS FAILED 

modname VSCS INITIALIZATION FAILED—-GLOBAL CONNECT FAILURE, IPTYPE = iptype 
modname |UCV GLOBAL CONNECT FAILURE, RETURN CODE = nn 

Note: This message is the result of an error from GCS or CP. 

modname DYNAMIC LOGO UPDATE status reason 

DTITTASK COMMUNICATION SERVICES INITIALIZATION FAILED. VSCS TERMINATING. 
DTIITASK ATTACH FAILED FOR DTISUTSK, RETURN CODE = xx 

DTIITASK IDENTIFY FAILED FOR DTISUTSK RETURN CODE = xx 

modname ABNORMAL TERMINATION OF VSCS IS IN PROGRESS INITIATED BY mod2 
DTIUSERn COMPILED WITH THE WRONG LEVEL OF DTIGEN MACRO 

DTIUSER=n SPECIFIED IN DTIGEN MACRO DOES NOT MATCH START PARAMETER 
modname |UCV RECEIVE FAILURE, IUCV RETURN CODE = nn 

Note: CP provides the IUCV return code. . 
modname VSCS ABEND FOR (PSIVSIUS) PROCESS — SYSTEM COMPLETION CODE = xxxx 
INTERNAL VSCS ERROR — modname n [luname] 


Note: If this happens during initialization and you have supplied a DTIUSERx for initialization, it may be a 
DTIUSERx specification error. 


modname FAILURE FOR reqtype RETURN CODE = rspirtncd rplifdb2 
modname VSCS INITIALIZATION FAILED-OPEN ACB FAILURE, ACBERFLG = xx 
VSCS INITIALIZATION ABORTED, SYSTEM RESET REQUIRED 


Figure 21. Messages Indicating VSCS Initialization Problems 


A Loop Occurs during Initialization 
If 90% — 100% of CPU time is being used and that is not a normal workload for the 
CPU, the problem could be one of the following: 
¢ GCS is dumping the virtual machine. 


e A VTAM temporary storage shortage has occurred, and VSCS is trying the 
VTAM request again. 
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e VSCS, VTAM, or GCS may have a control block chained to itself, resulting in 
an infinite loop. 


e There is a loop in CCS or IUCV, so that the VSCS virtual machine appears to 
be looping, but is not. 


lf VSCS is running in the same virtual machine as VTAM, it is very difficult to deter- 
mine where VSCS is looping because of the low priority at which VSCS is running. 
If you are using the TRACE BRANCH trace to record the loop, the trace must run 
for at least one minute. 


lf a dump message is issued, see “VSCS Terminates Immediately upon Starting” 
on page 145 for information on how to proceed. 


1. Determine amount of storage available. 


To determine the amount of VTAM storage available and which storage pools 
need to be enlarged, use either the SMS (buffer use) trace or the VTAM 
DISPLAY BFRUSE command. These service aids are described in 

Chapter 11, “Using VSCS Service Aids (VM).” 


2. If you cannot find any errors from the display of the VTAM buffer pools, collect 
this documentation: 


e A few seconds of the CP virtual machine branch trace. See Table 80 on 
page 1165 to determine what book describes the CP virtual machine 
branch trace. 


¢ VSCS dump. 

e VSCS operator console listing. 

e VSCS trace with CCS active, running before the loop started. 

e VSCS trace with any other options active, running before the loop started. 


e Series of loop addresses obtained with the CP DISPLAY PSW command or 
from the CP virtual machine trace output. 


To determine what book describes CP commands and the CP trace for 
your operating system, see Table 80 on page 1165. 


3. Go to “Reporting the Problem to IBM” on page 112. 


Other Initialization Problems 
1. Are parameters specified correctly in the DTIGEN macro? 


Figure 22 on page 150 shows messages issued for a problem involving incor- 
rect parameters. 


The parameter value representing the DTIUSER number must be a number in 
the range 0-9, and one byte in length. If you do not get the correct DTIUSERx 
module in message DTIIO7I, re-access the VSCS LOADLIB and make sure you 
enter this command correctly: 


VSCS START PARM=x (where x is the DTIUSER number) 


If you are still experiencing problems, have an assembly listing of the DTIGEN 
macroinstruction available and go to “Reporting the Problem to IBM” on 
page 112. 
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DTIIO7! USING INITIALIZATION PARAMETERS IN CSECT csectname 
DTII08! INITIALIZATION CSECT csectname NOT FOUND OR INVALID 
DTIIO9I INVALID INITIALIZATION START PARAMETER 

DTII10! DEFAULT INITIALIZATION PARAMETERS BEING USED 


DTII111 LOAD OF INITIALIZATION CSECT DTIUSERn FAILED, 


LOAD ABEND CODE = yyy, REASON CODE = zzz 


DTII151 DTIUSERn COMPILED WITH THE WRONG LEVEL OF 


DTIGEN MACRO 


DTII16I DTIUSER = n SPECIFIED IN DTIGEN MACRO DOES NOT MATCH 


START PARAMETER 


Figure 22. VSCS Messages Useful in Analyzing a Parameter Problem 


2: 


4. 


Is VSCS accessing the proper DTIUSERx? 


lf you see message DTII10I, either you did not select the correct DTIUSERx, or 
the loadlib containing the proper DTIUSERx module is not accessible. Issue 
the QUERY LOADLIB command and see if the correct loadlib is displayed in 
the query output. If the correct loadlib is not displayed, reissue the GLOBAL 
LOADLIB command, specifying the proper loadlib and all of the other loadlibs 
displayed in the query output, then restart VSCS again. Make sure the VSCS 
LOADLIB contains the DTIUSER you are trying to use. If you have verified that 
the DTIUSERx is correct, and you still have problems, get the portion of the 
operator console listing showing VSCS initialization and a list of the VSCS 
LOADLIB members. 


If you see message DTII11I, then the requested DTIUSERx was found, but an 
error occurred attempting to load it. Check the LOADLIB containing DTIUSERx 
for errors. 


. Was the DTIUSERx assembled with the correct level of the DTIGEN macro? 


If VSCS initialization detected a problem with the size or contents of the 
DTIUSERx loaded, message DTII15! will be issued. Verify that you replaced 
the DTIGEN macroinstruction in the VTAM MACLIB and that, when assembling, 
the correct VTAM MACLIB is set up using the GLOBAL MACLIB command. 


Go to “Reporting the Problem to IBM” on page 112. 


Termination Problems. 
VSCS issues one of the following messages to indicate termination is in progress: 
DTII131 modname NORMAL TERMINATION OF VSCS HAS BEEN INITIATED 


BY mod2 


DTII141 modname ABNORMAL TERMINATION OF VSCS IS IN PROGRESS INI- 


TIATED BY mod2 


The DTII141 message is usually followed by a request for a dump. 


If you receive message DTII13I, and you did not enter the VSCS HALT or QUIT 
operator command, and VTAM is not terminating, check for previous VSCS or 
VTAM messages. They may indicate why termination is in progress. 


Problems during termination include: 
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“Termination Never Completes” on page 151 

“VSCS Terminates Prematurely” 

“User's Session Terminates Prematurely” on page 153 

“Operator Commands Terminate VSCS Unexpectedly” on page 154 
“Other Termination Problems” on page 154. 


Choose the symptom most like yours and follow the procedure for that problem. 


Termination Never Completes 
1. Was termination initiated by a VSCS operator command? 


If so, get aa VSCS dump and go to “Reporting the Problem to IBM” on 
page 112. If not, issue the VSCS HALT command. 


Note: If the VSCS Utility Services subtask abended previously, normal termi- 
nation cannot take place, and you must issue the VSCS CANCEL command to 
terminate VSCS. 


2. Is VSCS still in a wait state? 


Display all active sessions with the VTAM DISPLAY LU and VSCS DISPLAY 
ID=/luname commands. Issue a VTAM VARY INACT command for each active 
session. This should allow VSCS to continue the termination. If this does not 
complete termination, use the VSCS FORCE ID=/uname command. 


3. Is termination still not completing? 
Get the following documentation: 


¢ VSCS operator console listing 
e VSCS dump (see “VSCS Dump” on page 453). 


Use the VSCS CANCEL command to terminate VSCS. 
4. Go to “Reporting the Problem to IBM” on page 112. 


VSCS Terminates Prematurely 
1. Did message DTIP15! appear? 


This indicates that presentation services caused the termination. Get the fol- 
lowing documentation: 


e VSCS dumps, if available (generated by previous VSCS abends or VSCS 
internal errors). 


e VSCS operator console listing showing any messages that tell which 
module invoked VSCS termination. 


e Trace output from any VSCS traces active at the time of VSCS termination. 
Go to “Reporting the Problem to IBM” on page 112. 
2. Did message DTIVO2I appear? 


If you receive this message, issue a VTAM BFRUSE command and see if the 
VTAM CRPL buffer pool has expanded. If the problem is not caused by buffer 
expansion, get the following documentation: 


e VSCS VTAM exit trace, if running at the time of the problem 
e VSCS dump. | 


Go to “Reporting the Problem to IBM” on page 112. 
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Note: Message DTIVO2I is issued each time a RECEIVE ANY macroin- 
struction request fails. Message DTIVO5I is issued only when all RECEIVE 
ANY RPLs are inactive. | 


. Did an ABENDOAQ occur? 


This abend code indicates that VTAM terminated while processing under 
control of the VSCS VTAM services subtask. You must get this documentation: 


e VSCS VTAM exit trace if running at the time of the problem 
¢ VSCS dump created for any previous VSCS abends. | 


Go to “Reporting the Problem to IBM” on page 112. 


. Did VSCS terminate with abend code 878 or 804? 


If so, collect the following documentation: 
¢ VSCS dump created for the abend. 


e VSCS global and storage control blocks. Process the VSCS dump with 
PRTDUMP, using VSCS dump formatter options 1 and 2. These options 
format the VSCS global and storage control blocks. 


¢« VTAM storage shortage documentation. 


Go to “Reporting the Problem to IBM” on page 112. 


_ Did VSCS terminate with another abend code? 


If recovery is possible, a message indicates that recovery is in progress and 
processing will continue. 


If recovery is not possible, VSCS issues message DTII14I and begins termi- 
nation. Recovery cannot occur for these abend codes: 


QA8 OAOI 122 13E 222 322 422 522 
All but 13E and 222 automatically produce a dump. 
In addition to this dump, get: 
¢ VSCS trace with CCS active, at the time of the abend 


e VSCS operator console listing showing messages around the time of the 
abend. 


Go to “Reporting the Problem to IBM” on page 112. 


. ls there a storage shortage? 


A storage shortage can cause VSCS to terminate. See “Storage-Related 
Problems” on page 179 for more information. Issue the VSCS STORAGE 
command and the first message, DTIS15I, indicates if there is currently a VSCS 
storage shortage. 


. Did any network failures just occur that involve VSCS logical units? 


If so, and if SCIP recovery is specified for VSCS, then both VSCS and VTAM 
require additional storage to perform recovery. 


See “Controlling VSCS SCIP Recovery” in the VTAM Network Implementation 
Guide for information on controlling VSCS SCIP recovery. 


Note: If the VTAM VARY LOGON command is used to attach all LUs to 
VSCS, do not use SONSCIP=YES in the APPL definition for VSCS. 
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8. Is there a VTAM storage shortage? 


Use the VTAM DISPLAY BFRUSE command to determine if any VTAM buffer 
pools are experiencing a shortage. If you cannot execute a DISPLAY 
command, use the VTAM SMS (buffer use) trace. These service aids are 
described in Chapter 11, “Using VSCS Service Aids (VM).” 


If the shortage is affecting VSCS directly, the following messages may appear: 


e One or more DTIVO2I messages 
e IST5611 (storage unavailable) 
e 1ST154lI (storage expansion failure). 


When a VTAM RPL-based macroinstruction fails with rpirtncd = 08 and rplfdb2 
= 00, there is a shortage of either VTAM LPBUFs or VTAM CRPLs. Normally, 
08 with 00 indicates that VTAM actually ran out of CSA while attempting to 
expand a buffer pool. The defined size of CSA may be too small. Determine if 
the size of the CRPL or LPBUF buffer pools are fixed in real storage by 
checking the F operand on the VTAM CRPLBUF and LPBUF buffer pool start 
options. If CRPL and LPBUF are fixed and VSCS is running in a separate 
virtual machine than VTAM, then VTAM may not be able to expand its buffer 
pool from the VSCS virtual machine. Determine if the DIAG98 directory option 
is specified for the VSCS virtual machine. The DIAG9Q8 directory option allows 
VTAM to expand its fixed buffer pools in an application's virtual machine. 
DIAG98 prevents RPL-based macroinstructions from failing with a storage 
shortage when CSA is available. 


See “Buffer Pools” in the VITAM Resource Definition Reference tor information 
on VTAM buffer specifications. If you cannot resolve the problem by adjusting 
the depleted VTAM buffer pools, go to “Reporting the Problem to IBM” on 
page 112. 


9. If you do not know the cause of the termination, collect the following documen- 
tation: 


© VSCS dump 
e VSCS operator console listing 
e Output from any traces active at the time of the problem. 


Go to “Reporting the Problem to IBM” on page 112. 


User's Session Terminates Prematurely 
1. Are there any messages on the VSCS operator console listing? 


Check the console for VSCS messages indicating that the logical unit is being 
terminated, or has just been terminated. These messages may indicate a 
reason for the termination. 


2. Was a VTAM VARY INACT, VSCS FORCE, or CP FORCE command issued? 
If any of these operator commands were issued, VSCS responded by termi- 
nating the logical unit. 


3. Did any errors occur during request processing for this device? If so, get the 
following documentation: 


e VSCS trace running externally with all options active except FRE and GET 
¢ VIT, specify OPT=(API,MSG,PIU), MODE=EXT | 
e If the failing LU is known, MODIFY TRACE TYPE=BUF, ID=/uname. 
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4. Did the termination occur right after a particular command was issued or a spe- 


cific application program was started from a particular device type? If so, report 
the command or application program. 


If you can, re-create the problem with all VSCS trace options active, and report 
that information. Otherwise, provide as many details as you can about the 
device you were using, and about the problem. 


. If you have not resolved the problem, go to “Reporting the Problem to IBM” on 


page 112. 


Note: Use of exception response mode may increase the frequency of 
session terminations because of limited error recovery, which is considered 
normal operation for VTAM V3R1.2 and later. 


Operator Commands Terminate VSCS Unexpectedly 
Do commands other than HALT, CANCEL, or QUIT cause VSCS to terminate? If 
so, note what these commands are. Get the operator console listing and any 
dumps that were produced, and go to “Reporting the Problem to IBM” on 
page 112. | 


Other Termination Problems 
If you have a different problem with termination, or you do not know what the 
problem is, get: 


e VSCS dump 
e VSCS operator console listing 
e Output from any VSCS traces that are active. 


Go to “Reporting the Problem to IBM” on page 112. 


VM Logo Problems on an SNA Device 


Before looking into potential problems in VSCS logo processing, make sure that the 
logo appears correctly on a CP-controlled terminal. 


If message DTIC16l is issued during initialization, the VM logo received from CP 
does not fit on a 24x80 display screen, or the VM logo contains extended data 
stream commands. This may indicate why the normal (standard) logo is not used. 


If you have modified the VM logo, see if the default VM logo works. If it does, your 
modified logo may not be supported on VSCS. 


If you decide to write your own logo, keep the following points in mind: 


e Changes to the VM logo are considered to be user modifications. For informa- 
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tion about VSCS limitations with the VM logo, see “VM Logo Usage” in the 
VTAM Network Implementation Guide. 


User modification of the command lines is not recommended. 


Use of start buffer address (SBA), repeat to address (RA), erase unprotected to 
address (EVA), or insert cursor (IC) commands are not allowed when modifying 
the logo body. These screen commands will be replaced with blanks (hex 40), 

which may alter the appearance of the logo. Other screen commands may not 

be accepted by all types of display devices, and may result in I/O errors. 
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e The default colors are white for the online message and blue for the logo body 
and input area. If you change the colors, you must start with the online 
message. If you use start field (SF) commands to control the colors, you must 
protect the online message and logo body. 


e Imbedded screen control commands are taken into consideration when evalu- 
ating the width of a logo line. 


e The value of the start field attribute byte must be within the range hex 40 
through hex FE. If you do not define a value within this range, VSCS replaces 
the start field order (start field ID and attribute) with the value hex 4040. After 
replacement, the following can occur: 


— Logo data is improperly positioned (for example, logo lines are shifted all 
over the screen). 


— Alternate logo displays because the width of the user-defined logo exceeds 
the width of the screen. 


See “VM Logo Usage” in the VTAM Network Implementation Guide for any VSCS 
logo uniqueness. 
Check the following symptoms for your problem. 

1. Logo lines shifted all over the screen and logo is not readable. 


a. Verify that the appropriate VTAM logmode entry for the logical unit was 
used. (See “Determining Device Characteristics” on page 135.) 


b. If VSCS data exit (DTIPDDSO) is coded, verify that the exit is not altering 
the start buffer addresses or the screen attributes in the outbound data 
stream. 


2. Only the online message is displayed. 


This indicates that both the normal logo and the single-line (alternate) logo 
exceeded the capacity of the device. 


a. Verify that the appropriate VTAM logmode entry for the logical unit was 
used. (See “Determining Device Characteristics” on page 135.) 


b. Verify that either the normal or the single-line (alternate) logo will fit on the 
screen size of the failing logical unit. 


3. Only a single-line (alternate) logo is displayed. 


This indicates that the combination of the normal logo, online message, and 
command lines would not fit on the screen because line width a logo body) or 
number of lines allowed was exceeded. 


a. Verify that either the normal or the alternate logo will fit on the screen size 
of the failing logical unit. 


b. Verify that the appropriate VTAM logmode entry for the logical unit was 
used. (See “Determining Device Characteristics” on page 135.) 


4. Screen colors or highlighting are incorrect or missing. 


a. Verify that the appropriate VTAM logmode entry for the logical unit was 
used. (See “Determining Device Characteristics” on page 135.) 


b. Check the modified logo to confirm that screen color and highlighting are 
inserted correctly. 
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c. If the VSCS data exit (DTIPDDSO) is coded, verify that it is not altering the 
start buffer addresses or the screen attributes in the outbound data stream. 


5. The logo fields are unprotected. 


This can be normal when using the start field (SF) command to create high- 
lighting or color in the logo body. 


a. Check the modified logo to confirm that screen color and highlighting are 
inserted correctly. 


b. Ensure that any embedded set attribute commands are paired (balanced) in 
the normal logo. 


c. If the VSCS data exit (DTIPDDSO) is coded, verify that it is not altering the 
start buffer addresses or the screen attributes in the outbound data stream. 


6. Logo flashes on the screen several times, then the USSMSG is displayed. 


When this happens, there should be an indication at the LU of the type of error 
that is occurring. Check for any DTIC16I messages that occurred at initialization 
time along with the characteristics of the LU. (See “Determining Device 
Characteristics” on page 135.) The most likely causes are: 


e Logo contains characters or commands not supported by the LU. 
e The wrong command code was used to send the logo. 
e The wrong VTAM logmode was used. 


7. Command line problems. 
Note: Alteration of the command lines is not recommended. 
a. Cursor positioned wrong, or missing. 


The command lines provided by VM contain an Insert Cursor command in 
the first available position of the user ID field. If this command is missing, 
then the cursor can be positioned anywhere. 


b. Command lines protected 


1) Ensure that any embedded set attribute commands are paired (bal- 
anced) in the normal logo. 


2) If the VSCS data exit (DTIPDDSO) is coded, verify that it is not altering 
the start buffer addresses or the screen attributes in the outbound data 
stream. 


c. Input from command lines results in incorrect input. 


1) Verify that the appropriate VTAM logmode entry for the logical unit was 
used. (See “Determining Device Characteristics” on page 135.) 


2) If the VSCS data exit (DTIPDDSI) is coded, verify that it is not altering 
the start buffer addresses or data in the input data stream. 


8. Did the logo problem occur after receiving message DTIC13I? 


Check for messages DTIC15I and DTIC16I. If you receive either of these mes- 
sages, correct the problem, update the logo, and try to log on again. 


9. Did message DTIC111 appear? 


The DTIC111 message indicates that the CCS subcomponent of CP has 
requested that the global path be severed. VSCS should produce a dump. 
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10. Did the logo update fail? 
If you failed to update the logo, you should receive message DTIC14l, indi- 
cating why the update failed. 


Go to “Reporting the Problem to IBM” on page 112. 


Logon Problems 


1. Issue the VTAM DISPLAY and VSCS DISPLAY |ID=netid.luname commands 
and answer the following questions: 


e Does the session exist? 


e If the session exists, do the device characteristics match the logical unit 
characteristics? 


e If the RPL is busy, what is the current RPL command? 


See “General Procedures to Diagnose Hung Logical Unit Problems” on 
page 131 and “Determining Device Characteristics” on page 135 for more 
information. 


_ 2. Are you logging on to VSCS for the first time? 


lf so, and if you are not using the VTAM-supplied logmode entries, the logmode 
entries are probably incorrect. If you are logging on from an MVS or VSE host, 
that host must provide customized logmode entries. Review the process for — 
building your own MODETAB and logmode entries in “Session Parameters for 
Devices: Logon Mode Tables” in the VTAM Network Implementation Guide 
(VSCS requirements in the PSERVIC field). 


3. Are you trying to log on in logo mode? 


When you turn on the power for your terminal, the VM logo appears on the 
screen. To log on, use one of the following methods: 


e Press ENTER and the PA1 or the PA2 key, and enter your logon informa- 
tion. 

e Enter the user ID and the password in the appropriate fields on the logo. 

e Enter the logon user ID in the command field on the logo. 


Note: If message DTIC15I is received during VSCS initialization, you cannot 
log on from the logo screen. 


If you cannot log on in logo mode, try logging on in no-logo mode. If the 
problem still exists, you are probably using the wrong logmode entry. (See 
“Determining Device Characteristics” on page 135.) 


If the problem goes away, a user-designed logo may be causing the problem. 
(See “VM Logo Problems on an SNA Device” on page 154.) 


To pursue the problem further, collect the following documentation: 


e VSCS trace for the failing logical unit with all options active except FRE 
and GET. 


e VTAM internal trace, OPT=API 
e VTAM buffer contents trace for the failing logical unit 
¢ Output from the VSCS DISPLAY |ID=netid.luname command, if possible. 
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e Description of what is on the screen 
e VSCS console log. 


4. Did you get message DTIC11I indicating IUCV global path severed, or 
message DTIP14I with a return code indicating that the IUCV global path is 
severed? 


If so, get data from the VSCS CCS trace and any VSCS internal error dumps 
taken. Get the documentation if available, and then go to “Reporting the 
Problem to IBM” on page 112. 


If not, issue VMEXIT, which should return the logical unit to VTAM. Then issue 
the VSCS DISPLAY command. If the logical unit is not found, the problem is 
with VTAM. 


5. Is the terminal hung? 
e If so, has the VM logo been removed from the screen? 
— If so, you need the following documentation: 


- VSCS trace for the failing logical unit with all options active except 
FRE and GET. 


- VTAM internal trace. Ensure that the API option is set (OPT=API). 
- VTAM buffer contents trace for the failing logical unit. 
- VSCS console log. 
— If not, go to step 3 on page 157. 
e If not, is the VM logo or VTAM USSMSG10 on the screen? 
— If so, you need the following documentation: 


- VSCS trace for the failing logical unit with all options active except 
FRE and GET. 


- ‘VTAM internal trace. Ensure that the API option is set (OPT=API). 
- VTAM buffer contents trace for the failing logical unit. 
- VSCS console log. 
— If not, go to step 6. 
6. Get other documentation. 


In addition to any documentation you have collected so far, get the VSCS CCS 
and VTAM exit trace for the failing logical unit. 


7. Are all terminals hung? 


If so, go to “All VSCS LUs Are Hung or Slow (Affects Logons and Current 
Sessions)” on page 161. 


8. Go to “Reporting the Problem to IBM” on page 112. 
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Logoff and Disconnect Problems 
If the terminal is hung, go to page 172. 


1. Record the status of the terminal. For example, on a display screen, note what 
is in the status area, the last input or the last output to the logical unit. 


2. Issue the CP QUERY NAMES command and note whether the logical unit 
name is known to CP. 


3. Issue the VTAM DISPLAY and VSCS DISPLAY !D=netid.luname commands 
and note the following: 


e Whether the session exists 
e What the current RPL command is 
e Whether the RPL is busy. 


See “General Procedures to Diagnose Hung Logical Unit Problems” on 
page 131 for more information. 


4. Collect more documentation: 


e Device type, model, and current state (use VSCS DISPLAY 
|ID=netid.luname) 


e CCS and VTAM trace output 
e Any other VSCS trace output available 
e VSCS dump using DUMPLU. If the LU is not found, use GDUMP. 
Note: The VSCS dump formatter will print a single logical unit on request. 
5. Find the logical unit control blocks in the VSCS dump and look at the following: 


a. The current state of each logical unit. It will be PLB LBCSTATE or VLB 
LBCSTATE. VTAM Data Areas for VM/ESA describes these states in more 
detail. 


b. What is the status of the SEND RPL? Note whether it is busy, and note 
whether it contains any errors. 


c. Note whether the logical unit has any work to process. This is indicated by 
the existence of DTIWEBs for this LU in the dump. 


6. After collecting all documentation, go to “Reporting the Problem to IBM” on 
page 112. 


Wait and Loop Problems 


Complete the preliminary procedure below, and if the problem persists, choose the 
symptom that most closely matches yours. Follow the procedure given for your 
symptom. 


e “All VSCS LUs Are Hung or Slow (Affects Logons and Current Sessions)” on 
page 161 


e “One or More Logical Units Hung” on page 163 
e “VSCS Operator Commands Do Not Complete” on page 175 


e VSCS is looping, see “Presentation Services Is in a Large Enabled Loop” on 
page 162. 
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If you still cannot identify the condition, continue with “Loop” on page 86 or “Wait” 
on page 67. : 


Note: The term “hung terminal” means the user is speeded by the system from 
entering data. 


Preliminary Procedure for Problems Involving All Logical Units 


This is a fairly short procedure that can help you isolate some common reasons 
that cause all logical units to hang. 


1. Is VSCS dispatchable? 


160 VTAM V4R2 Diagnosis 


Use the following commands to see if VSCS can process anything: 


e Does VSCS respond to the VSCS QUERY command? 
e Does “VSM” show up when the #CP QUERY NAMES command is issued? 
e Does VTAM respond to the VTAM DISPLAY commands? 


If the answer to all three questions is yes, VSCS is dispatchable and the global 
IUCV connection is intact. Continue with step 2. 


If one or more answers is no, the problem could be one of the following: 
e Higher-priority task is looping 
e VSCS is looping 
e VSCS (or GCS) is waiting for an I|UCV instruction to complete. 


If the loop or wait occurs during initialization, go to “Initialization Problems” on 
page 143. 


If the problem occurs during termination, go to “Termination Problems” on 
page 150. 


If the problem occurs during logon, go to “Logon Problems” on page 157. 


If the problem occurs during logoff, go to “Logoff and Disconnect Problems” on 
page 159. Get a VSCS dump (see step 3), and go to “Reporting the Problem 
to IBM” on page 112. 


If the problem occurs after VSCS is up and running, go to “VSCS Operator 
Commands Do Not Complete” on page 175. 


Note: If aVSCS dump is in progress, it will appear that all users are hung and 
no console commands will complete. When the dump has completed, proc- 
essing will resume. 


. Look at operator console output. 


The VSCS, VTAM, and CP console listings may contain messages that explain 
your present condition. Check for VSCS or VTAM messages that indicate that 
a network failure occurred and error recovery is in progress. For example, 
message DTIS31I might tell you that VSCS is taking a dump. 


. Get a VSCS dump and a VSCS internal trace. 


If a dump is not in progress and the VSCS console does not respond to com- 
mands issued in “running” status, use the #CP VMDUMP 0:END FORMAT 
GCS command in CP mode. For more information on the VSCS dump, see 
“VSCS Dump” on page 453. 
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To determine what book describes the CP operator commands for your oper- 
ating system, see Table 80 on page 1165. If possible, obtain the VSCS 
internal trace before you recover the logical unit. 


4. Examine the logical unit control blocks and trace output. 


In the dump, find the logical unit control blocks TAB, PLB, and VLB. The 
VSCS internal trace, used along with information from the control blocks, may 
show the reason for the hang. 


Note: The VTAM VARY INACT, VSCS FORCE, and CP FORCE commands 
cause bits to turn on and off in the PLB and VLB. Those bits are used to 
determine the reason for a hung logical unit. Therefore, attempt to gather doc- 
umentation before using those commands, unless you suspect one of them is 
the cause of the problem. 


5. Is it a network problem? 


A network problem, such as VTAM failing to terminate a session successfully, 
or outstanding I/O, may cause logical units to hang. To diagnose VTAM prob- 
lems, see Chapter 2, “Collecting Documentation for Specific Types of 
Problems.” 


Note: Before determining that the problem is a VSCS problem, issue the 
VSCS DISPLAY |ID=netid.luname to determine whether I/O is active (RPL is 
busy). 


All VSCS LUs Are Hung or Slow (Affects Logons and Current 
Sessions) 


If all VSCS logical units are hung or experiencing slow response time, the problem 
is likely to be in one of the following areas: 


Problem Symptoms 


Global IUCV path severed e VSCS issues great quantities of DT| messages 
e Users cannot log on (DTIV12l) 
e Message DTIP14I 
e Message DTIC11I. 

Presentation services in a large e Loop symptoms 

enabled loop — LU response time is slower than normal 


— VSCS virtual machine is using a much larger 
amount of CPU (90 to 100%) 
— VSCS console does not respond 
e All VSCS trace entries are the same. 


VSCS task in a wait in VTAM e VSCS DISPLAY of LUs known to be hung shows 
SEND RPL IS BUSY 

No VTAM RECEIVE ANY RPLs e Message DTIVOS5I 

active e Message DTIVO2lI 


e VSCS dump shows inactive RPLs. 


Determining whether VSCS is the cause of a loop can be difficult. The following 
can cause the loop: 


e VTAM is recovering from a network failure (if VSCS is in the same virtual 
machine as VTAM). 


e VSCS is in SCIP recovery after a network failure. 
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SCIP recovery has occurred after a large network outage and the values of 
SCIPNUM and SCIPTIM are 0. 


GCS is dumping the virtual machine. 


A VTAM temporary storage shortage has occurred, and VSCS is trying the 
VTAM request again. 


VSCS, VTAM, or GCS may have a control block chained to itself, resulting in 
an infinite loop. 


Because of a loop in CCS or IUCV, the VSCS virtual machine appears to be 
looping but is not. 


Note: Check the VSCS console log to see if error recovery is in progress. 


Choose the problem most like yours, and follow the procedure for it. 


Presentation Services Is in a Large Enabled Loop 


1; 


2. 


Is VSCS showing symptoms of a loop? 
These symptoms are typical ofa loop problem: 


e Extremely slow response time 
e 90 to 100% of CPU time used 
e VSCS console does not respond. 


Do any VSCS trace entries indicate a loop? 


Look at the VSCS internal trace table on the screen or in a dump and see if all 
of the trace entries are the same. (See “VSCS Trace Facility” on page 458 for 
a description of the VSCS trace records). If so, the VSCS CCS trace entries 
could indicate if VSCS or CP is continuously sending |UCV requests or replies. 
The VSCS dispatcher trace entries show whether VSCS is in an internal loop 
processing a single work element. 


On the screen, use the VSCS QUERY command (see “VSCS QUERY 
Command” in VTAM Operation) to find the starting address of the VSCS 
internal trace table. Then display the address of the current entry with the 
command | 


D xxxxxx.20 


where xxxxxx is the current trace entry (the VSCS trace table address +8 is the 
address of the current entry). Record what you see. Wait a minute or two and 
repeat the procedure above. If the VSCS trace entries are the same, and only 
the VSCS CCS trace is active, then VSCS is in a loop, VSCS is waiting for an 
event to complete, or there is currently no work to process. 


To find the internal trace table in a dump, use the pointer at SABTRHDR in the 
DTISAB. If VSCS is in a loop, the current and preceding trace entries may 
look the same, depending on the trace options that are active. 


. Find the current logical unit. 


You can find the logical unit being processed by presentation services in the 
current (last used) entry in the VSCS internal trace table. 


4. Use the dispatcher trace to verify the loop. 
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6. 


7. 


If VSCS is looping on one work element block (DTIWEB), you will see it re- 
dispatched for the same logical unit over and over. For information on the dis- 
patcher trace, see “VSCS Trace Facility” on page 458. 


Note: If you limit the number of users on the system at the time of the loop, 
the extent of the loop may be more apparent in the save areas. 


. Examine the dispatcher work element queue in a VSCS dump. 


The presentation services dispatcher work element queue is located in module 
DTIISDA1 in a dump. The address of this module in a dump is shown in the 
VSCS trace table header and in the link-edit listing. If the queue shows a long 
chain of work to do, VSCS may be in a loop or a permanent wait. If so, the 
problem will be associated with the current user identified by the dispatcher. 


Get the following documentation: 


e VSCS trace for the failing logical unit with all options active except FRE 
and GET. 


° VIT, specify OPT=(API,MSG,PIU), MODE=EXT. 


e A few seconds of virtual machine branch trace on the VSM, to trace only 
the VSCS address range. 


The beginning of the VSCS load module can be found by use of the VSCS 
QUERY command (if VSCS TRACE is active). Message DTIS74I contains 
the starting address of the VSCS trace table. Use CP DISPLAY Txxxxx.50 
and VTAM Data Areas for VMW/ESA to find the addresses in the | 
THDRSTRT and THDRSDA2 fields. Those addresses represent the extent 
of the VSCS load module. 


Note: Use the CP TRACE command instead of the PER command to 
trace only address ranges of VSCS that you want to trace. PER is 
accepted only as an alias for the CP TRACE command. See Table 80 on 
page 1165 to determine what book describes the virtual machine branch 
trace. 


e VSCS dump | 
e VSCS operator console listing. 


Go to “Reporting the Problem to IBM” on page 112. 


One or More Logical Units Hung 
If multiple terminals are hung, you need to determine if all VSCS terminals are 
hung with only a few reporting, or the terminals are hung for different reasons. If 
you cannot log on to VSCS, you have a global hang and should use the procedure 
described in “All VSCS LUs Are Hung or Slow (Affects Logons and Current 
Sessions)” on page 161. If you can log on to VSCS, then follow the procedure for 
a single hung terminal for each terminal. 


If a single terminal is hung, follow these steps: 


1. 


2. 


3. 


Use the “General Procedures to Diagnose Hung Logical Unit Problems” on 
page 131. : 


Get the required documentation from “Getting the Required Documentation” on 
page 164. 


Try to clear the hang. 
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e For local non-SNA VSCS terminals, press the RESET key. 
e For remote VSCS terminals, do one of the following: 


a. Turn the power off, then on. 
b. Use the TEST ON/OFF switch. 


c. For SNA logical units, press the ALT and SYS REQ keys, then enter 
LOGOFF to VTAM. 


d. Press the ATTN key. 


e. Have the operator issue one or more of the following commands from 
the VM or VTAM console: 


VTAM TERMSESS 

VTAM VARY INACT, FORCE, ID=luname 
VTAM VARY INACT, IMMED, ID=luname 
VSCS FORCE ID=netid. luname 

CP FORCE userid 


Getting the Required Documentation 

VSCS terminal hang conditions can be grouped into two categories: re-creatable 
hangs and non-re-creatable hangs. Each category requires specific procedures for 
gathering the documentation needed by IBM support personnel to identify and 
resolve the problem. 


A re-creatable hang exists when you can anticipate a failure occurring and can 
begin gathering critical information. Usually, you can re-create the problem while 
running various traces. After recreating the problem, you can gather other pertinent 
documentation including dumps and logs. 


A non-re-creatable hang exists when changes occur in the time, frequency, and LU 
associated with the problem. Variations in contributing conditions, therefore, do not 
allow you to anticipate the problem. For example, you may know that a certain 
hang problem occurs twice each day. However, you do not know when specifically 
or for which LU the problem will occur. Because of these uncertainties, you must 
run traces that capture information for all LUs running in the system. The large 
volume of data produced by this global tracing requires you to consider a number 
of factors. 


The VSCS tracing facility has features to handle both re-creatable and non-re- _ 
creatable hangs. For re-creatable hangs, you can run VSCS traces externally to 
allow the output to be spooled while other traces in the GCS group are running (for 
example, the VTAM buffer trace). For non-re-creatable hangs, you can run VSCS 
traces internally and route output to a VSCS global trace table, or to each LU's 
individual trace table. 


Gathering Trace Information for Re-creatable Hangs: For re-creatable prob- 
lems, gather the trace information described in this section. 


Note: You must activate the following system external tracing facilities to capture 
output from traces running in external mode: 


e TRSAVE and TRSOURCE 
e GCS ETRACE. 
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See “Collecting External Trace Data (VM)” on page 359 for more informa- 
tion on collecting, formatting, and viewing external trace output. Do not use 
ACF/TAP to format VSCS traces. 


e VSCS trace output for the individual LU (netid./uname) having the problem. 
Specify all options except FRE and GET, as follows: 


VSCS TRACEON netid.luname (CCS DISP VTAM DAT EXT 
e VTAM buffer contents trace for the individual LU. Specify the trace as follows: 
VTAM MODIFY TRACE, TYPE=BUF, ID=luname 


e If you suspect the problem is in VTAM, or if the problem is very disruptive, run 
the VTAM internal trace (VIT) in external mode, as follows: 


VTAM MODIFY TRACE, TYPE=VTAM,OPT=(API ,MSG,PIU,PSS,SMS,SSCP) ,MODE=EXT 


One indication of a VTAM problem is a VSCS display of reeds DTIS65I, 
showing that the RPL is BUSY. 


Notes: 


1. It is normal for message DTIS59I to indicate that “RECEIVE SPECIFIC 
RPL IS BUSY.” Message DTIS59I is displayed only if you are using the 
RECEIVE SPECIFIC option of VSCS. 


2. The VIT traces all activity in VTAM. If possible, run the VIT when the 
system is not being used heavily. 


After all necessary traces are active, re-create the problem. It is helpful to activate 
the traces before the LU actually logs onto the VSCS application. This allows the 
trace to contain the BIND. When activating a VTAM buffer trace, VTAM must know 
about the LU in the host where the trace is activated. However, if the LU is cross- 
domain or cross-network to this VTAM, then VTAM defines the LU as a cross- 
domain resource (CDRSC) at logon time. Unless it is explicitly defined in a 
CDRSC major node, a CDRSC is not known by the VTAM that it is logging onto. 
Consequently, VTAM does not allow you to start a buffer trace for the LU until the 
LU is logged onto the application program. 


To capture the logon sequence in a trace, use the following techniques to enable a 
buffer trace to start before a CDRSC logs onto an application: 


e Define the CDRSC in a CDRSC major node. (VTAM allows you to define a 
CDRSC major node while VTAM is running.) 


1. Create the major node file in CMS. (All major node files have a filetype of 
VTAMLST.) 


2. Link to the disk from the VTAM virtual machine using CP LINK. 
3. ACCESS the disk from the VTAM virtual machine. 
4. Issue VTAM VARY ACT,ID=name command. 


e Use the VTAM function that “remembers” a CDRSC for a limited amount of 
time after it establishes a session with this host. The VTAM CDRSCTI start 
option specifies the amount of time VTAM retains dynamically defined CDRSCs 
after the last session with this host has terminated. The default is 8 minutes. 
Assuming the default value is in effect, you can log the LU onto VSCS, then log 
the LU off VSCS and have 8 minutes to activate the VTAM buffer trace and 
re-log the LU onto VSCS. 
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When you have re-created the problem, immediately stop all traces. Do not 
attempt any recovery until you have gathered all necessary documentation. 


Gathering Dump Information for Re-creatable Hangs: For re-creatable prob- 
lems gather the dump information described in this section: 


e Unless the problem itself automatically causes a dump, obtain a dump of the 
VTAM virtual machine immediately after you re-create the problem. 


If the VSCS controlling this LU is not running in the same virtual machine as 
VTAM, obtain a dump of the virtual machine in which VSCS is running. To 
determine which VSCS virtual machine controls this LU, issue the following CP 
command: 


#CP QUERY NAMES 


QUERY NAMES lists the LUs controlled by a specific VTAM service machine 
(VSM). See Table 80 on page 1165 to determine which book contains more 
information on CP operator commands. 


To obtain a dump of VSCS without significantly impacting your system, issue 
the following command: 


VSCS DUMPLU ID=netid. luname 


The DUMPLU command executes quickly, but dumps only the areas of storage 
that actually pertain to the LU. Usually, the limited information supplied by 
DUMPLU is sufficient to diagnose a problem with an LU. 


If more information on the VSCS virtual machine is needed, you may need to 
obtain a full VSCS virtual machine dump. To obtain a full dump, issue the fol- 
lowing CP command: 


#CP VMDUMP 0-END FORMAT GCS DSS TO userid 


Note: This VMDUMP command causes the entire virtual machine to stop 
while the dump is running. 


e Collect the VTAM and VSCS, if separate, console logs. 
In summary, use the following commands to activate traces and dumps for re- 
creatable hangs: 
e VSCS TRACEON 
e VSCS TRACEON netid.luname (ALL EXT 
e VTAM MODIFY TRACE 
e VTAM MODIFY TRACE, TYPE=BUF, ID=luname 
lf VSCS is running in a different virtual machine than VTAM: 
e VSCS DUMPLU ID=netid. luname 
lf VSCS is running in the same virtual machine as VTAM: 
° #CP VMDUMP 0-END FORMAT GCS DSS TO userid 


The following command may be required, depending on the circumstances and 
severity of the hang condition: 


e VTAM MODIFY TRACE, TYPE=VTAM, OPT=(API,MSG, PIU,PSS,SMS,SSCP) ,MODE=EXT 
For the VTAM virtual machine: 
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e #CP VMDUMP 0-END FORMAT GCS DSS T0 userid 


Gathering Trace Information for Non-re-creatable Hangs: _\|n order for IBM 
support personnel to diagnose and correct your non-re-creatable hang problem, the 
VSCS trace should be active with the following options: 


Option Equivalent DTIGEN Operand 


CCS CSTRACE=Y 
DISP DPTRACE=Y 
DAT DTTRACE=Y 
VTAM VTTRACE=Y 
ILU ILUTRAC=Y 


For best results, it is recommended that you specify these options using the 
DTIGEN macroinstruction instead of the VSCS TRACEON command. 


When these trace options are active, VSCS records trace entries in the VSCS 
global trace table and in each individual LU's trace table. The ILU (ILUTRAC) 
option causes each LU logged onto VSCS to have its own trace table with entries 
specifically related to the LU. When an LU hang occurs, the LU's trace table 
should “hang” as well. Consequently, the events immediately preceding the hang 
are captured in the table. The activity of other LUs does not cause the hung LU's 
trace table to be overwritten (wrap). 


The SIZE (ILUSIZE) trace option controls the size of the individual LU table. It is 
recommended that you do not change this value unless IBM support personnel 
request the change when you are working on a problem. The default SIZE is 40 
entries, which allows a sufficient amount of information in the table without using an 
excessive amount of storage. Each entry is 32 bytes in size. Before you specify 
and activate the ILU and SIZE options, ensure that you have sufficient private 
storage available in the VSCS virtual machine. For example, assume your system 
has a maximum of 1000 users logged onto VSCS at one time. If you use the 
default size of 40 entries, the following amount of storage is dedicated to individual 
LU trace tables: 40+1 entries/table * 32 bytes/entry * 1000 users = 1250K (approxi- 
mately 1.25 megabytes). 


Note: 1 is added to the number of entries because the size of the individual LU 
trace table header is also 32 bytes. 


Gathering Dump Information for Non-re-creatable Hangs: For non-re- 
creatable problems gather the dump information described in this section. 


Note: You must take the dumps described in this section before you attempt 
recovery actions with commands such as VSCS FORCE, CP FORCE, or VTAM 
VARY INACT. 


e If you suspect the problem is in VTAM, or if the problem is very disruptive, take 
a dump of the VTAM virtual machine immediately after the problem occurs. 
One indication of a VTAM problem is a VSCS display of message DTIS65I, 
showing that the RPL is BUSY. 


Note: It is normal for message DTIS59I to indicate that “RECEIVE SPECIFIC 
RPL IS BUSY.” Message DTIS59I is displayed only if you are using the 
RECEIVE SPECIFIC option of VSCS. 


Take a dump of the controlling VSCS virtual machine as soon as possible after 
the problem occurs. If you already have a dump of the VTAM virtual machine 
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and the VSCS that controls this LU is running in the same virtual machine as 
VTAM, then you do not need an additional dump. 


If the VSCS controlling this LU is not running in the same virtual machine as 
VTAM, you need to obtain a dump of the virtual machine in which VSCS is 
running. To determine which VSCS virtual machine controls this LU, issue the 
CP QUERY NAMES command. QUERY NAMES lists the LUs controlled by a 
specific VTAM service machine (VSM). See Table 80 on page 1165 to deter- 
mine which book contains more information on CP operator commands. 


To obtain a dump of VSCS without significantly impacting your system, issue 
the following command: 


VSCS DUMPLU ID=netid. luname 


The DUMPLU command executes quickly, but dumps only the areas of storage 
that actually pertain to the LU. Usually, the limited information supplied by 
DUMPLU is sufficient to diagnose a problem with an LU. 


lf you need more information on the VSCS virtual machine, you can obtain a 
full VSCS virtual machine dump. To obtain a full dump, issue the following CP 
command: 


#CP VMDUMP O-END FORMAT GCS DSS TO userid 


Note: Using VMDUMP to dump the entire VTAM and VSCS virtual machines 
causes the virtual machines to stop while the dump is running. Consequently, 
VSCS and VTAM users are affected by VMDUMP. 


e Collect the VTAM and VSCS, if separate, console logs. 
In summary, use the following commands to activate traces and dumps for non-re- 
creatable hangs: 
e VSCS TRACEON (CCS DISP VTAM DAT ILU 
or the equivalent VSCS DTIGEN operands: 
e CSTRACE=Y ,DPTRACE=Y, VITTRACE=Y , DTTRACE=Y, ILUTRAC=Y 
e VSCS DUMPLU ID=netid. luname 
or 
e #CP VMDUMP 0-END FORMAT GCS DSS TO userid 


Determine When the Hang Occurred 
Choose from the following list the description that most closely matches your situ- 
ation, and go to that procedure. 


Logical unit hangs while end user is using a full-screen application 
program, such as SPF or XEDIT (see page 169). 


Logical unit hangs while end user is in console mode or CMS mode (see 
page 170). 


2 

3 | Logical unit hangs when end user switches between full-screen mode and 
console or CMS mode (see page 171). 

4 


Logical unit hangs after error condition during purge, logoff, or cleanup. 
This may be indicated by a message (see page 172). 
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Logical unit hangs after message DTIC 101 because the path is already 
severed (see page 173). 


Logical unit remains hung after operator issues VTAM VARY INACT, VSCS 
FORCE, or CP FORCE commands (See page 173). 


Other (see page 174). 


Logical Unit Hangs While You Are Using Full-Screen Mode or When the 
Logical Unit Is Dialed 


1. 


Is a full-screen application program (such as XEDIT or SPF) responsible for the 
failure? 


In full-screen mode, the application program is responsible for formatting the 
screen, unlocking the keyboard, and reading input data. If the application 
program does not handle these functions properly, the device can be hung. 


Indications of this are: 
e PROGxxx message 
e Message limit is reached 


e Message ‘NOT ACCEPTED’ appears when you press the enter key. 
This indicates that the application issued a WRITE with keyboard restore, 
but did not retry the previous input data. 


e The keyboard is locked. 


If you have indications of a full-screen application program failure, get a dump 
of the user’s virtual machine and go to “Reporting the Problem to IBM” on 
page 112. 


. Ils the logmode defined incorrectly? 


Signs of this are: 


e Incorrect characters appear on the screen. 
e The colors are wrong. 

e The screen size is wrong. 

e The logical unit is disconnected. 


Use the VSCS command DISPLAY |ID=netid.luname to see if the device is 
defined correctly. (See “Determining Device Characteristics” on page 135 for 
more information.) If the logmode is defined incorrectly, see “Logon Mode 
Table” in the VTAM Resource Definition Reference and correct the logmode 
definition. 


If the logmode is correct, continue with this procedure. 


. Did an OPCHECK occur? 


Signs of this are: 


e The application program ends. 
e The output for a color display shows the wrong colors. 
e The logical unit is disconnected. 


lf OPCHECK conditions exist, get the VSCS CCS trace and VTAM buffer con- 
tents trace on the failing logical unit for documentation. 


Go to “Reporting the Problem to IBM” on page 112. 
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4. Is the logical unit hung or data lost after a CP message was displayed or input 
was entered? 


While a logical unit is in full-screen state, VSCS should display no CP mes- 
sages (except warnings and priority messages) until input is received (at which 
time the full-screen application is notified of input available). 


If you coded DTIGEN option FSREADSN, then you can expect loss of data: 
e |f the screen is interrupted before input is received from the logical unit 


e If modified data input is available, CP messages were displayed, and the 
buffer data is requested by the full screen application. 


Note: The full-screen application program is responsible for restoring the key- 
board after input is received. If the keyboard is not restored, the logical unit . 
remains hung. 


Get the VSCS trace with CCS, DISP, and VTAM active, and a VSCS dump. 
(See “VSCS Trace Facility” on page 458 and “VSCS Dump” on page 453 for 
more information on getting this output.) 


Go to “Reporting the Problem to IBM” on page 112. 
5. Is the logical unit still hung? If so, get this documentation: 


e VSCS CCS, DISP, and VTAM exit traces for the failing logical unit 
e VSCS dump of the logical unit using DUMPLU. 
e VTAM SMS (buffer use) trace for the failing logical unit. 


Go to “Reporting the Problem to IBM” on page 112. 

Logical Unit Hangs While You Are Using Console Mode or CMS Mode 
Note: The CMS full-screen command puts the logical unit into full-screen state. 
1. Is the logical unit waiting for the previous command to be displayed again? 

If so, then one of the following occurred: | 


e The command has not completed and CP did not notify VSCS (via 
command completion or timer expiration) to display the input again. 


e The command was executed by the full-screen application program and the 
application did not display the information again. 


e The input has not been accepted. 


Get a VSCS CCS trace for the failing logical unit and a VSCS dump. Then go 
to “Reporting the Problem to IBM” on page 112. 


2. Is the logical unit hung after a ‘MORE’, ‘HOLDING’, or ‘NOT ACCEPTED’ con- 
dition? 


lf so, use DUMPLU to get a VSCS dump of the logical unit and get the VSCS 
CCS and dispatcher traces. Then go to “Reporting the Problem to IBM” on 
page 112. 


_ 3. Are the VSCS data translation exits coded? 


The following VSCS user exits affect the logical units' reactions to any out- 
bound data streams and CP's reaction to inbound data streams: 


DTIPDNTI LU1 inbound data 
DTIPDNTO LU1 outbound data 
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DTIPDDSI display input data 
DTIPDDSO display outbound data. 


If the problem does not appear to be a problem in the user-coded exit, get the 
following documentation: 


¢ VSCS CCS trace 
e VSCS DATA trace 
e VTAM buffer contents trace for the failing LU. 


Go to “Reporting the Problem to IBM” on page 112. 
4. Is the problem with a 3279 color terminal (type 0 logical unit)? 


Make sure FEATUR2=EDATS is specified in one or more of these NCP defi- 
nitions: 


LINE 
GROUP 
CLUSTER 
TERMINAL. 


Note: FEATUR2=EDATS is not supported for non-SNA devices attached 
through ICAs. 


Also, check the coding of the user exits (DTIPDDSI and DTIPDDSO). 


If color or highlighting still does not work correctly, get the following documenta- 
tion: 


e VSCS CCS and VTAM exit traces, and data for the failing logical unit 
e VTAM buffer contents trace for the failing logical unit. 


Go to “Reporting the Problem to IBM” on page 112. 
5. Is the device dialed to another system? 
If so, go to the full-screen procedure on page 169. 


Note: Dialing to PVM and passing through to another CMS system gives the 
appearance of normal console and CMS screens. However, VSCS receives 
the entire screen already formatted, including the status area, and processes 
the data as full-screen data. : 


6. Documentation for problems not described above: 
If you can re-create the problem, get: 


e VSCS trace for the failing logical unit with all options active except FRE 
and GET 


e VSCS dump of the logical unit using DUMPLU 
¢ VIT, specify OPT=(API,MSG,PIU,PSS,SSCP), MODE=EXT 
e VTAM buffer contents trace for failing logical unit. 

If you cannot re-create the problem, get: 


e VSCS trace with CCS active, for only the failing logical unit, if possible 
e VSCS dump of the logical unit using DUMPLU 
e VTAM logmode being used. 


Go to “Reporting the Problem to IBM” on page 112. 
Logical Unit Hangs When You Switch Modes 
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1. Does your terminal hang when you switch between modes? For example: 


e Console mode to CMS mode 

e CMS mode to console mode 

e CMS or console mode to full-screen mode 
e Full-screen mode to CMS or console mode. 


2. If so, get the following documentation: 
If you can re-create the problem, get: 


e VSCS dump of the logical unit using DUMPLU 

e VTAM buffer contents trace 

e VSCS CCS and dispatcher traces with just the failing logical unit traced 
e VIT, specify OPT=(API,MSG,PIU,PSS,SSCP), MODE=EXT. ; 


If you cannot re-create the problem, at least obtain the following: 


e VSCS dump of the logical unit using DUMPLU 
e VSCS trace with CCS and DISP active. 


3. Go to “Reporting the Problem to IBM” on page 112. 

Logical Unit Hangs During Logoff or Disconnect Processing 
1. Have any messages been issued? 

Get the operator console log and look for messages that pertain to the hang. 
2. Determine the component that sent the message. 


If the message has a return code, use Table 13 to determine the component 
that may have sent the message. Then look in VIAM Messages and Codes to - 
see what the return code means. 


If the message has no return code, use the message prefix to determine where 
the message is coming from. Page 146 has a list of the message prefixes for 
each component. 


Table 13. Source of Return Codes 


Message Source of Return Codes 
DTIPxxx « GCS 
e VM 
e VSCS 
DTISxxx ° VM 
e VSCS 
DTIVxxx e VTAM 


3. Are other components connected to the logical unit? 


Answering these questions may indicate which components are still communi- 
cating with the logical unit. 


¢ Does the VSCS command DISPLAY |ID=netid.luname show the status of 
the device? (See “Determining Device Characteristics” on page 135 for 
more information.) 


¢ Is the user still logged on to VM? Try the CP QUERY NAMES command. 
If the logical unit name and user ID appear, the logical unit is connected to 
VM and the CP IUCV connection is intact. If the response is gibberish, the 
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logical unit is not connected to VM and the CP IUCV connection has been 
severed. 


e Does VTAM show the logical unit still in session with VSCS? (Use the 
VTAM DISPLAY command.) 


4. Note the status of the logical unit at this time. For example, on a display 
screen note what is in the status area, and what was the last input or the last 
output to the logical unit. 


5. Collect documentation before recovery. 
lf you can re-create the problem, get: 


e VSCS dump of the logical unit using DUMPLU 

e VTAM buffer contents trace 

e VSCS trace for the failing logical unit with all options active except FRE 
and GET. 


If you cannot re-create the problem, get: 


e VSCS dump of the logical unit using DUMPLU 
e VSCS trace with CCS active. 


6. Recover the logical unit with one or more of these commands: 


e CP FORCE 
e VTAM VARY INACT 
e VSCS FORCE. 


7. Go to “Reporting the Problem to IBM” on page 112. 
Logical Unit Hangs After Receiving Message DTIC10I 
1. Did these symptoms occur? 


Message DTIC10I indicates that an IUCV request or response was received on 
the global path after an I|UCV SEVER was issued by VSCS. Most of the time 
this does not cause a problem, because CP logs off or disconnects the logical 
unit when the IUCV SEVER is processed. If it is a problem, it could produce 
these symptoms: 


e Abend 

e VSCS message DTII14 

e Loss of operator communications 

e Message GCTIXT413T indicates that the signal services path is severed. 


2. Collect documentation. 


e VSCS dump of the logical unit using DUMPLU 
e VSCS trace with CCS active, running for all logical units. 


3. Go to “Reporting the Problem to IBM” on page 112. 
[J Logical Unit Stays Hung after You Use VARY INACT or FORCE Command 


1. Try to use both the VTAM VARY INACT and CP FORCE commands. If you 
issue the CP FORCE command and the resource is unknown, CP might be 
waiting for an |UCV reply before completing the termination process for the 
logical unit. Try to use the VTAM VARY INACT command. 


If the logical unit is still hung, continue with step 2. 


2. Determine which components are still connected to the logical unit. 
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Use the VSCS command DISPLAY |ID=netid.luname to determine the 
status of the logical unit and of the SEND RPL. 


Is the user still logged on to VM? 


Does the logical unit name appear when you use the CP QUERY NAMES 
command? If so, the VM connection has not been severed. 


Does VTAM show the logical unit still in session with VSCS? Use the 
VTAM DISPLAY command to determine this. 


From this information, try to determine which components are connected to the 
logical unit. 


3. Note the status of the logical unit at this time. For example, on a display 
screen, what is in the status area, and what was the last input or the last output 
to the logical unit? 


° Note: If the user logged off and the screen says “HOLDING,” you must clear 
the screen before the logical unit can be disconnected from VM. (This is 
normal for VSCS.) 


4. Collect documentation. 


If you can re-create the problem, get: 


VSCS dump of the logical unit using DUMPLU 
VSCS operator console listing 
VTAM buffer contents trace 


VSCS trace for the failing logical unit, running externally, with all options 
active except FRE and GET. 


VIT, specify OPT=(API,MSG,PIU,PSS,SSCP), MODE=EXT. 


If you cannot re-create the problem, get: 


VSCS dump of the logical unit using DUMPLU 
VSCS operator console listing 
VSCS CCS and dispatcher trace. 


5. Go to “Reporting the Problem to IBM” on page 112. 


Logical Unit is Hung for Other Reasons 


1. Answer these questions. 


a. 


e. 


Issue the CP QUERY NAMES command on the CP console. Does the 
logical unit name appear? 


. ls VSCS still controlling the logical unit? (Use the VTAM DISPLAY 


command to discover this.) 


. Have any messages appeared on the VTAM or VSCS operator console for 


this logical unit? 


. What is the last sequence of messages issued? (See the VSCS operator 


console listing.) 
Issue VSCS DISPLAY |D=netid.luname. |s the RPL busy? 


2. Collect documentation. 


If you can re-create the problem, get: 
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3. 


e VSCS dump of the logical unit using DUMPLU 
e VSCS operator console listing 
e VTAM buffer contents trace 


e VSCS traces for the failing logical unit, running externally, with all options 
active except FRE and GET. 


e VIT, specify OPT=(API,MSG,PIU,PSS,SSCP), MODE=EXT. 
If you cannot re-create the problem, get: 


e VSCS dump of the logical unit using DUMPLU 
e VSCS operator console listing 
e VSCS CCS and dispatcher trace. 


Go to “Reporting the Problem to IBM” on page 112. 


VSCS Operator Commands Do Not Complete 


1. 


Has the VSCS utility services subtask abended? 


Check the operator console listing to see if the utility services subtask abnor- 
mally terminated. If this occurred, VSCS can do no further processing of oper- 
ator commands. Use the VSCS CANCEL command to terminate VSCS, then 
get the dump generated by the abend and go to “Termination Problems” on 
page 150. | 


. Does a GCS message indicate a problem with the GCS console task? If that 


task abended or could not get storage, operator commands cannot reach 
VSCS. 


. If the problem is not an abend or GCS console task, try these commands: 


e If VSCS is running in the same virtual machine as VTAM, enter a VTAM 
command such as DISPLAY LU. Does it complete? 


— If yes, VSCS may be in a loop or a permanent wait. 
— If no, the problem is in the VTAM virtual machine. Continue down this 
list to determine where the problem is. 


e Enter the CP QUERY TIME command. This shows whether GCS is proc- 
essing and passing CP commands to CP. 


e Enter #CP QUERY NAMES. This shows whether CP commands are being 
processed. 


. Does GCS process some commands, but not others? Does the PA1 key put 


the terminal in CP READ mode? 


If the answer to both questions is yes, GCS is looping or waiting for an event to 
complete. In CP READ mode, issue SET RUN OFF. Then enter the CP 
command D PSW to display the current PSW. Display the storage around the 
address shown in the second half of the PSW. If the last instruction issued 
was X'B2FOxxxx', CP has not completed an IUCV request, and VSCS and the 
virtual machine are permanently waiting for a response. If the problem does 
not involve an IUCV instruction, check to see if the WAIT bit is on in the PSW. 
If so, the problem is in the VSCS virtual machine. Get a VSCS dump and go 
to “Reporting the Problem to IBM” on page 112. The VSCS dump is described 
in “VSCS Dump’ on page 453. 
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Message Problems: Message DTIS99I Indicates a VSCS Internal Error 


For messages other than DTIS99I, go to “Message Problem” on page 93 in 
Chapter 2, “Collecting Documentation for Specific Types of Problems.” 


Message DTIS99I tells you that a VSCS internal error occurred for module 
DTIxxxxx and a number (n). The number identifies the reason the message was 
issued. Use the lists below to determine which component of VSCS issued the 
message. 


Note: If an LU is involved with the internal error, the LU name receives the 
DTIS99I message. See the following example: 


DTIS99I INTERNAL VSCS ERROR — DTIPRSVR 1 


This indicates that VSCS attempted to issue an IUCV SEVER for the VSCS global 
path. For this error, a dump is taken (if dumping is enabled) and the SEVER 
request is ignored. 


1. Presentation services issues messages with this information: 


Module n Error Description 

DTIPDADV 1 SEND-in-progress bit error 

DTIPDFSS 1 Full screen request DTIWEB not valid 

DTIPICPY 1 SEND-in-progress bit error 

DTIPIFSI 1 SEND.-in-progress bit error 

DTIPIQRY 1 WSF query reply contained a character-sets structured field with a 
descriptor length (DL) of 0 

2 WSF query reply contained an implicit-partition structured field with 

a length of 0 


WSF query reply contained a structured field with a length of 0 


WEBFUN or WEBMODE or LBCSTATE is not valid 
Return code received is not valid 


3 
DTIPISYN 1 SEND/REPLY WEB type is not valid 
DTIPOCWR 1 SEND-in-progress bit error 
DTIPOFWR 1 SEND-in-progress bit error 
DTIPOWIC 1 SEND-in-progress bit error 
DTIPOWRT 1 SEND-in-progress bit error 
2 SEND-in-progress bit error 
DTIPRACT 1 Received a WEB that is not valid 
DTIPRLGO 1 SEND-in-progress bit error 
DTIPRSVR 1 Attempting to issue a SEVER for global path ID 
DTIPRWEB 1 WEB is not valid 
DTIPSCFS 1 FS response WEB is not valid 
DTIPSCPY 1 SEND-in-progress bit error 
2 SEND-in-progress bit error 
DTIPSFCR 1 SEND-in-progress bit error 
DTIPSPIN 1 SEND-in-progress bit error 
DTIPSTAM 1 Queue tag error for work element queue 
2 
3 


2. VTAM services issues messages with this information: 


2 APAR VM51150: DTIPIPUT does not issue message DTIS99I for error conditions. 
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Module 

DTIVCLSX 
DTIVLOFF 
DTIVPURG 


DTIVRECA 
DTIVRECX 


DTIVREJR 
DTIVSIML 
DTIVSEND 


DTIVSNDX 


DTIVSTAM 


— st st 4s A= | 3g 
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Message Problems 


Error Description 


Schedule request to DTIVTRME failed 

No storage available 

IUCV connection exists 

Schedule failed 

Error in building WEB 

More than 16 zero-length middle-in-chain RU's were received for 
this LUNAME in one chain 

Input chain is not valid. RPLONLY, RPLFIRST, RPLMIDLE, and 
RPLLAST were all off 

Logical unit not in termination 

Schedule of WEBNVCLU to VTAM Services failed after 
SIMLOGON retry count was exhausted 

Request not valid 

RPL busy and recovery not in progress 

Recovery queue empty during recovery 

RPL response is not valid 

Dequeue error in recovery 

Data response not valid in recovery 

RPL response is not valid 

Recovery queue empty during recovery 

Recovery queue empty during recovery 

Attempting to schedule DTICMT 

Queue tag error for work element queue 

WEBFUN or WEBMODE or LBCSTATE is not valid 
Return code received is not valid 


3. System Services issues messages with this information: 


Module n Error Description 
DTISCHED 1 Process identifier is not valid 
2 Queue tag header is incorrect 
DTISDEQU 1 Queue tag does not match queue header 
DTISDSTO 1 Logical unit's VS PIBSTAT was not PIBRUN after dispatch of last 
work element. 
2 Logical unit's PS PIBSTAT was not PIBRUN after dispatch of last 
work element. 
DTISENQU 1 Chain pointer is not valid or queue tag does not match 
2 Pending queue depth exceeded 
DTISFREB 1 SMP tag is not valid 
2 Request is not valid (releasing storage that is already free) 
DTISFREM 1 SMP tag is not valid 
DTISGETB 1 Control block error or request is too big to obtain 
2 Free block count is not valid 
3 No storage obtained 
DTISLDMP 1 Internally requested partial dump failed with other than return code 
4. Full dump taken. 
DTISGMGR 1 PDBUSCNT (chain pointer) is not valid 


4. Documentation to collect for VSCS internal error problems: 


e Issuer of the message: presentation services, VTAM Services, or system 


services 


e Reason the message was issued 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


Chapter 4. Collecting Documentation for VSCS Problems (VM) 177 


Incorrect Output Problems — “Restricted Materials of IBM” 


Licensed Materials — Property of IBM 


e VSCS dump (produced automatically as a result of message DTIS99l) 
e VSCS operator console listing 


e Any VSCS traces that were active at the time of the error. 


Incorrect Output Problems 


1. 


Describe the incorrect output. The following list shows some of the possible 


symptoms: 
e The size of the display screen is incorrect. 
e The status area of the display screen does not appear as expected. 
e Highlighting or color does not work as expected. 


e Characters that are not valid appear in the output, such as EBCDIC, APL, 
TEXT, or double-byte kanji characters. (Characters that are not valid are 
any characters that are obviously wrong or that you do not expect.) 


e Input data is lost. 


e PROGxxxx occurs on SNA 3270s. If this happens during full-screen mode, 
the contents of the data stream may not be valid. If the terminal is not in 
full-screen mode, this message is more likely to indicate a VSCS problem 
or a logmode problem. | 


¢ The device does not function like a VM-supported terminal and the problem 
is not due to a known restriction. See “Operational Differences between 
VSCS and CP” on page 139 for additional information. 


e The incorrect output does not involve full-screen data or the VM logo, and 
one or more of the following symptoms occur: 


— Data is misplaced on the screen. 

— Data is missing. 

— Content of data is incorrect. 

— Device errors occur or the logical unit is disconnected when you 
execute a command or a program. 


2. Check to see that product restrictions are not causing the incorrect output. See 
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“Operational Differences between VSCS and CP” on page 139 for additional 
information. 


. Does the incorrect output involve the logo? See “VM Logo Problems on an 


SNA Device” on page 154 for more information. 


Note: If you enter both the user ID and the password on the user ID line, you 
may receive a different message ( HCP) than you do if you enter only the user 
ID. 


. Is the device defined correctly to VSCS? 


Use the VSCS command DISPLAY |!D=netid./uname to determine if the device 
is defined correctly to VSCS. If the DISPLAY command is not successful, get a 
dump of VSCS. The logical unit control blocks in a dump also show the LU 
definition. 


If the LU definitions are not correct for the device, correct them and retest the 
logical unit. See “LU Group Major Node” in the VTAM Resource Definition Ref- 
erence for more information on defining logical units. 
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5. Check to see if the appropriate VTAM logmode for the device is being used. 
See “Logon Mode Table” in the VTAM Resource Definition Reference for more 
information on logmodes. 


6. Are user translation exits involved? 


If your system has user-written translation exits, try to re-create the problem 
without them. Use the DTIGEN parameters or the VSCS CHANGE command 
to disable the user exits and see if the problem goes away. 


7. Is kanji support involved? 


Double-byte character support for kanji does limited editing. Check the data 
stream sent to see if it is within the limitations of double-byte support. 


Note: VSCS does not check whether the device supports kanji. The applica- 
tion has this responsibility. 


8. Are TWX 3101 configuration switches set up as documented by VM? To deter- 
mine what book describes how TWX 3101 configuration switches should be set 
up, see the “terminal configuration switches” entry in Table 80 on page 1165. 


9. Other possible causes of incorrect output are listed here. You may choose to 
investigate these further. 


e Functional limitation due to the release of VM used 
Hardware problem 

VSCS problem 

VM problem 

VM application problem. 


10. If the problem has not been solved, collect the following documentation: 


e For status area problems, lost input, device errors, and disconnections: 
— VSCS dispatcher trace of the failing logical unit 
— VSCS trace with CCS active, of the failing logical unit 
— VSCS VTAM exit trace of the failing logical unit 
— VTAM buffer contents trace. 
e For all other incorrect output problems: 
— VTAM buffer contents trace of the failing logical unit 
— VSCS trace with CCS active, of the failing logical unit 
— lf a VSCS dump is necessary, limit the number of users on the system 
and use the VSCS BFRFIFO command before re-creating the problem. 


Storage-Related Problems 


Issue the VSCS STORAGE command whenever you suspect that storage is 
Causing problems. 


1. Determine whether the virtual machine in which VSCS resides is large enough. 
Estimate this using the Estimating Storage for VTAM diskette. 
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Notes: 


a. If VSCS resides in the same virtual machine as VTAM, add the storage 
requirements for VTAM. | 


b. If either DTIGEN start option STCHKTM or STRELTM is not greater than 0, 
you do not get VSCS storage pool information. 


If the virtual machine is large enough for your environment, continue. Other- 
wise, correct the VTAM virtual machine size. 


2. If you are using new VSCS start options, evaluate changes made with DTIGEN 
parameters: 


e Trace table size 

Increase in the number of printers 

Receive buffer size 

BLKMULT greater than one 

VSAMLM number increased 

Transmit buffer sizes for both logical units and displays 
RECEIVE SPECIFIC option 

Exception response option. 


Note: The VSCS DISPLAY OPTIONS and the VSCS STORAGE commands 
display the majority of the DTIGEN parameters and start options that are cur- 
rently used by VSCS. 


lf VSCS ran properly before these changes, review the size of the VSCS virtual 
machine before reporting a problem. 


You can use the VSCS STORAGE command to see: 


Current number of VTAM sessions and CP connections 
Number of RECEIVE ANY RPLs being used 

Indicator of storage shortage in message DTIS15l 

Number of GETMAIN failures. 

Some of the DTIGEN options that are currently active 
Storage management parameters that have been specified 
Number of VEIBs allocated (controlled by VSAMLM). 


If VSCS is running in the same virtual machine as VTAM, use the VTAM 
DISPLAY BFRUSE command to determine VTAM's storage usage. 


3. Is the network in slowdown or recovery mode? 


If the network is in slowdown mode, it takes additional storage to maintain data 
destined for the logical unit. This symptom could also be caused by one of the 
following: | 


e VTAM is recovering from a network failure. 
e VSCS is in SCIP recovery after a network failure. 


e VSCS is in a different virtual machine than VTAM, and a dump is being 
taken for VSCS or VTAM. 


¢ A VTAM temporary storage shortage has occurred. 
e The I/O buffer pool has expanded for a VTAM-controlled device. 


4. Are several logical units hung? . 
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The storage being used by hung logical units remains allocated until the logical 
unit is released or terminated. If you are using the exception response mode 
and RECEIVE SPECIFIC options or the ILU trace option, the amount of storage 
used could be enough to cause a storage shortage. See “General Procedures 
to Diagnose Hung Logical Unit Problems” on page 131 before continuing. 


If you can re-create the problem or if it is occurring frequently, gather the fol- 
lowing documentation: 


e VSCS internal trace with options CCS, DISP, FRE, and GET active 
e Dump of the VSCS virtual machine. 


5. Did you receive message DTIS99! for DTISFREB or DTISGETB? 
This indicates that VSCS is having a problem managing storage blocks. 


If you can re-create the problem or if it is occurring frequently, gather the fol- 
lowing documentation: 


e VSCS internal trace with the options CCS, DISP, FRE, and GET active 
e Dump created when message DTIS99I is issued. 


Get a VSCS dump and go to “Reporting the Problem to IBM” on page 112. 
6. Did you receive message DTIS10I, followed by DTIV121? 


This sequence of messages indicates that either the virtual machine is too 
small, or all available storage has been depleted. If the VSCS virtual machine 
is large enough, the available storage may be allocated to a different VSCS 
storage pool than the current storage requester. 


For example, if storage is available in the presentation services pool, but VTAM 
services needs it, then GCS cannot provide additional storage. Logons are 
rejected until presentation services releases the storage. 


You can control the distribution of dynamic storage by coding the DTIGEN start 
options STCHKTM and STRELTM to allow swapping of storage segments from 
one pool to a different pool, or to return them to GCS. 


Note: You can use the CHANGE command to alter the DTIGEN storage 
options that control redistribution. 


Get the following documentation: 


e Before the problem occurs, start the VSCS trace with CCS, DISP, FRE, 
and GET options active for all logical units. If possible, run the VSCS trace 
in external mode. 


e VSCS dump. 
Go to “Reporting the Problem to IBM” on page 112. 
7. Is it an IUCV pacing problem? 


The values specified in the DTIGEN start options (DPACE for displays and 
KPACE for keyboards/printers) control |UCV pacing. 


For displays, the default value is the screen depth, which is also the default if 
the pace is set to 0. The screen depth varies by display type. 


For keyboard/printers, the default is 10. If the pace is set to 0 for 
keyboard/printers, there is no IUCV pacing. 
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Specifying no |UCV pacing can cause increased IUCV traffic, which can cause 
a VSCS storage shortage if VSCS is running in a large network or in a small 
virtual machine. 


For TWX logical units, the default is 1, and cannot be changed in VSCS. 


If IUCV pacing is not set properly, change the DTIGEN start option and reini- 
tialize VSCS with the new DTIGEN. Use the VSCS CHANGE command to 
alter the pace parameters temporarily. If the problem persists, get the following 
documentation: 


¢ Before the problem occurs, start the VSCS trace with CCS active. 
¢ VSCS dump. 


Go to “Reporting the Problem to IBM” on page 112. 


Note: Use the VSCS DISPLAY OPTIONS command to determine the current 
values of DTIGEN DPACE and KPACE start options. 


. Other 


If the problem cannot be isolated from previous steps, then you must take a 
dump of the VSCS virtual machine. After obtaining the dump, use the VSCS 
dump formatter to print the VSCS storage control blocks. If VSCS is in the 
same virtual machine as VTAM, then also evaluate the VTAM storage. 


Get the output from the VSCS formatter and the console log, and go to 
“Reporting the Problem to IBM” on page 112. 


Performance Problems 


i 
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Do not use a large value for the DTIGEN start option VSAMLM. This can 
Cause excessive paging in a medium-to-large environment. See Chapter 5, 
“VM/SNA Console Support (VSCS)” in the VTAM Resource Definition Refer- 
ence for more information on VSAMLM, and see the Estimating Storage for 
VTAM diskette to determine whether the virtual machine size is correct. 


Note: If VSCS is running in the same virtual machine as VTAM, include the 
VTAM storage size required when you determine the virtual machine size. 


One possible solution is to move VSCS to a separate virtual machine or to add 
a second VSCS virtual machine to share the work load. It is more costly to run 
VSCS in a separate virtual machine, but it helps prevent wasted time due to 
page faults. 


lf you think your performance problem is related to paging and storage (for 
example, you are getting slow response time for operator commands or logical 
units), collect this documentation: 


e VSCS dump 
¢ DTIGEN parameters 
e GCS internal trace for GETMAIN and FREEMAIN. 


Note: Use the VSCS DISPLAY OPTIONS command and VSCS STORAGE 
command to determine what most of the DTIGEN initialization parameters are 
currently set to. 


. If you think your performance problem is related to logical units (for example, 


you are getting slow response time for I/O operations), collect this documenta- 
tion: | 
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e VTAM I/O trace 
e VTAM buffer contents trace 


e VSCS trace for the failing logical unit, running externally, with all options 
active except FRE and GET 


e GCS internal trace for SIO and 1/O. 


3. If you do not Know the cause of the performance problem, collect all of the 
documentation in the two lists above, plus supply the values for MAXBFRU, 
UNITSZ, and |OBUF. 


4. When you have collected the necessary documentation, go to “Reporting the 
Problem to IBM” on page 112. 


Other VSCS Problems 


The following topics are covered in this section: 


“CHANGE Command Not Working” 

“SNA Dial Problems” on page 184 

“Printer Sharing Problems” on page 185 
“Operator Commands Are Rejected” on page 187. 


CHANGE Command Not Working 


The VSCS CHANGE command allows the operator to alter many of the VSCS start 
options dynamically. Dynamic alteration may not always provide the expected 
results. Consider the following before assuming there is a problem with the 
CHANGE command: 


e Timer values: 


Alteration of a timer value takes effect immediately. For example, if 
STCHKTM=3600 (one hour) and you change it to STCHKTM=60 (one minute), 
the previous timer is cancelled. 


e Buffer values: 


Alteration of a buffer value takes effect the next time the changed buffer is allo- 
cated. 


e LU logon-related values: 


Alteration of values used during the logon or connection to CP does not take 
effect until another LU logs on to VSCS or CP. 


e Recovery values: 
Alteration of recovery values takes effect immediately. 
e User exits: 
Alteration of the user exit options (DEXIT and KEXIT) takes effect immediately. 


Consider what the option you are changing is used for before determining that the 
CHANGE command did not work correctly. 


One other consideration is the buffer values set for DPXMTL, KPXMTL and 


RCVBFRL. When set with the CHANGE command, the value displayed with the 
DISPLAY OPTIONS command matches what was entered. However, when you 
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code the values on the DTIGEN macroinstruction, VSCS optimizes the values to 

utilize the maximum amount of storage available for the size specified. The opti- 

mization performed does not increase the storage required for those options. For 
more information on the operands that can be modified with the VSCS CHANGE 

command see “VSCS CHANGE Command” in VTAM Operation. 


SNA Dial Problems 


SNA dial keeps the logical unit in full-screen state from the time the dial is complete 
until the dial is dropped or reset. All of the information on the screen is supplied by 
the resource that was dialed. 


1. If the screen size changed after one of the following occurred, take the indi- 
cated action: | 7 


a. A VTAM logical unit dialed another virtual machine. 


Make sure the virtual machine you are dialing supports the features pro- 
vided by your logical unit. 


b. A VTAM logical unit, dialing PVM, dialed another GCS group or host con- 
taining VTAM. 


When dialing PVM, the logical unit is defined as a logical address, which 
may prevent the real device characteristics from being known. If you are | 
dialing another VTAM machine, supply a logmode name that describes the 
type of terminal you are using. 


If the screen size is still incorrect, collect the following documentation: 


e VSCS trace with CCS active 

e VSCS dump 

e VTAM buffer contents trace (in both hosts if connecting to another VTAM 
machine). 


2. Is the logical unit hung? 


If you are using PVM, find out whether the resource you are attempting to dial 
is active. An inactive resource could result in a hung logical unit. If the 
resource is active and the logical unit is hung, the resource, PVM, VSCS, CP, 
or GCS may be experiencing problems. Note whether other PVM users’ termi- 
nals are also hung. 


If you cannot determine the reason, get the following documentation: 


e VSCS dump 
e VSCS trace with CCS active (must be active before the hang occurs). 


In the VSCS dump, find the logical unit control blocks and the last few trace 
entries for that specific logical unit. From this, answer the following questions: 


a. Is the PLB LBCSTATE of the logical unit 20, 40 or 60? 
b. Is the SEND RPL busy, indicating VSCS is waiting for a response? 
c. Did VSCS respond to all outstanding requests? 


If the situation can be re-created, get the following documentation: 


e VSCS dispatcher and VTAM exit traces 
e VTAM internal trace, OPT=API 
e VSCS dump. 


Go to “Reporting the Problem to IBM” on page 112. 
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3. Is the I/O interrupt missing? 


If the situation is caused by missing I/O, run these traces exeinehy on just the 
failing logical unit: 


VSCS CCS and VTAM exit traces 
VIT, specify OPT=(CIO), MODE=EXT 
CP SIO, SIOF, and I/O traces 

GCS SIO and I/O traces. 


To determine what book describes the CP and GCS traces for your oper- 
ating system, see Table 80 on page 1165. 


Go to “Reporting the Problem to IBM” on page 112. 


Printer Sharing Problems 
1. Is VSCS printer sharing failing? 
If you coded a DTIGEN macroinstruction with PRTSHREN, do the following: 


a. Change it to PRTSHR=Y. 

b. Reassemble DTIUSER. 

c. Link DTIUSER to the VSCS LOADLIB. 

d. Reinitialize VSCS with the correct DTIUSER number. 


Note: You can change PRTSHR with the CHANGE command. 


Use the VSCS DISPLAY PRTTAB command to determine the status of 
PRTSHR and to determine which display (if any) is associated with each 
printer. 


If you are using default parameters or you are using a DTIUSER with 
PRTSHR=Y coded, get the following documentation: 


e VSCS dispatcher and VTAM exit traces 
e VSCS dump. 


Go to “Reporting the Problem to IBM” on page 112. 


2. Does VTAM SIMLOGON fail after you use the VSCS PRINTER command and 
| receive a COPY function for the defined printer? 


If the VTAM SIMLOGON fails, then make sure: 
e The printer name was spelled correctly 


e The resource is known and available to VTAM (use VTAM DISPLAY 
command) 


e The VTAM logmode for the printer logical unit is correct. 
3. Does “NOT AVAILABLE” appear in the status area of the display? 


In order for VSCS to access a VTAM printer, either the VSCS PRINTER 
command or a VTAM VARY ACT command must be issued first. See “VSCS 
PRINTER Command” and “VARY ACT Command” in VTAM Operation for more 
information on commands. | 


If the proper command was not issued or the printer name was misspelled, 
issue the command again with the correct name. Use the VSCS FORCE ID= 
command to remove the incorrect printer name from the printer table. 
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If the proper command was issued to identify the printer to VSCS, get the fol- 
lowing documentation: 


e VSCS dispatcher and VTAM exit traces 

e VTAM internal trace, OPT=API 

e VTAM buffer contents trace for the printer logical unit 
e VSCS dump. 


Go to “Reporting the Problem to IBM” on page 112. 
4. ls VSCS not releasing a printer when requested to? 


If the printer was allocated to VSCS by using the VTAM VARY 
ACT,LOGON=VSCS command, then a VTAM VARY INACT command is the 
only way to release it. 


If the VTAM SIMLOGON is used (check the VSCS operator console listing), 
VSCS uses the time value specified on the DTIGEN TIMEREL start option to 
determine when to release the printer. 


Note: Make sure that SIMLOGON is for an LU printer device. See Chapter 5, 
“VM/SNA Console Support (VSCS)” in the VTAM Resource Definition Refer- 
ence for more information on TIMEREL. 


If the correct value for TIMEREL is specified and VSCS was initialized with the 
proper DTIUSER module, get the following documentation: 


VSCS dispatcher and VTAM exit traces 

VSCS dump 

VTAM internal trace, OPT=API 

VTAM buffer contents trace for the printer logical unit before the release 
was requested. | 


Go to “Reporting the Problem to IBM” on page 112. 
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5. Other printer problems: 
For problems not described above, get the following documentation: 


e VSCS dispatcher and VTAM exit traces 
e VTAM internal trace, OPT=API 
e VSCS dump. 


Go to “Reporting the Problem to IBM” on page 112. 


Operator Commands Are Rejected 
Does VSCS reject a command that was entered correctly and issue an error 
message? You may have entered the command at an inappropriate time. For 
example, a VSCS START command is rejected when VSCS is already active. Try 
using some other commands to see if they work. 


Note: Avoid using VSCS HALT, CANCEL, or QUIT; they could cause further prob- 
lems. 


If the problem is unique to one command, or to a certain sequence of commands, 
get the operator console listing and go to “Reporting the Problem to IBM” on 
page 112. 
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Part 2. Diagnostic Procedures 


Chapter 5. Using DISPLAY and MODIFY Operator Commands ...... 193 
Using VTAM DISPLAY Commands for Problem Determination ........ 194 
Display Buffer Pool Use .............. 00000 eee eee . 195 
Display NCP Storage ......... 2.0... 20. ee 196 
Display Resource Status ........... 2.0.0.0. cee eee ee 196 
Display Path Tables ...... 0... 20... 2. ee ee 197 
Display Resources ina Pending State ..................... 197 
Display Route Status ......... 20.0.0 0. ee 198 
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Using the Independent NCP Dump Utility (Channel-Attached Controller 
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Maintenance and Operator Subsystem (MOSS) Dump (3720, 3725, and 3745 
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Formatting and Printing Dump Output (MVS) (VM) .......... ae ee 232 
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Chapter 5. Using DISPLAY and MODIFY Operator Commands 


You can control and monitor the VTAM program network with start options and 
operator commands. These commands include the following: 


e DISPLAY commands 


— “Using VTAM DISPLAY Commands for Problem Determination” on 
page 194 

— “Display Buffer Pool Use” on page 195 

— “Display NCP Storage” on page 196 

- “Display Resource Status” on page 196 

— “Display Path Tables” on page 197 

— “Display Resources in a Pending State” on page 197 

— “Display Route Status” on page 198 

— “Display Route Test” on page 205. 

— “Display Traces” on page 208 


e MODIFY commands 


— “Using VTAM MODIFY Commands for Problem Determination” on 
page 209 

— “Modify Input/Output Problem Determination” on page 209 

— “Modify Message Module Identification” on page 210 

— “Modify NCP Intensive Mode Recording” on page 210 

— “Modify SDLC Link Level 2 Test” on page 211 

— “Modify Tuning Statistics” on page 212 

— “MODIFY VTAMOPTS Command for Changing Start Option Values” on 
page 212 


For information on VTAM start options, see Chapter 4, “Start Options” in the VTAM 
Resource Definition Reference. 


For information on commands, see Chapter 2, “VTAM Operator Commands” in 
VTAM Operation. 


Note: You can also use the NetView program to monitor and collect error statistics 
from the VTAM network. Planning for NetView, NCP, and VTAM describes this 
licensed program. 
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Using VTAM DISPLAY Commands for Problem Determination 


VTAM provides DISPLAY (D) commands to show status and other information 
about network resources. The following list shows what kind of information is dis- 
played for each of the VTAM DISPLAY commands. For more information on the 


syntax and output of these commands, see Chapter 2, “VTAM Operator 
Commands” in VTAM Operation. 


Command Information Displayed 

D ADJCLUST Adjacent cluster table definitions in the current ADJCLUST table 

D ADJCP Status of adjacent CP major nodes 

D ADJSSCPS Adjacent SSCP tables 

D APPLS Status of application program major and minor nodes | 

D BFRUSE VTAM buffer usage 

D BNCOSMAP Native and nonnative COS mapping defined for a border node 

D CDRMS Status of cross-domain resource manager major and minor nodes 

D CDRSCS _ Status of cross-domain resources (including independent LUs) 

D CLSTRS Status of clusters (PUs in NCP, local SNA, and switched major nodes) 
D CNOS Change-number-of-sessions characteristics for LU 6.2 application programs 
D CONVID Conversations with LU 6.2 application programs 

D COS Class-of-service table names 

D CPS Contents of the call progress signal (CPS) table 

D DIRECTRY Information maintained by central directory server 

D DISK Disk contents of 3720 or 3745 Communication Controller 

D DLURS All dependent LU requesters for which this host acts as Dependent LU Server 
D EXIT Status of user-written exit routines 

D GROUPS Status of line groups 

D ID Individual major or minor nodes 

D LINES Status of lines and channel links 

D LMTBL LU-mode table for LU 6.2 application programs 

D LUGROUPS LUGROUP major nodes, model LU groups, and model LUs 

D MAJNODES Status of major nodes 

D MODELS Model PUs and LUs 

D NCPSTOR Storage contents of 3720 or 3745 Communication Controller 

D NETSRVR Network node server information 

D PATHS Dial-out path information 

D PATHTAB Status of explicit routes and virtual routes 

D PENDING Resources in a pending state 
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D ROUTE 


D RSCLIST 
D SESSIONS 
D STATIONS 
D STATS 

D STORUSE 
D TABLE 

D TERMS 

D TGPS 

D TOPO 

D TRACES 
D TRL 


Status of explicit routes and virtual routes; existence of routes; whether a route is oper- 
ational 


Resources whose names match a particular pattern 

Session status information 

Status of cross-subarea link stations 

Storage information for use by the Estimating Storage for VTAM diskette 
Storage usage for storage pools and data spaces 

Table type, use count, and users 

Status of device-type LUs (terminals) 

Transmission group profiles 

Topology of APPN network (information about nodes and transmission groups) 
Status of VTAM and NCP traces 


Information about the TRL major node or about a single TRLE definition statement 


D TSOUSER Status of a TSO user ID 


D USERVAR 


D VTAMOPTS 


USERVARs and the application programs associated with them 
Start options 


Display Buffer Pool Use 
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You can use the DISPLAY BFRUSE command to display information about buffer 
use. In response to this command, VTAM indicates that the display is for buffer 
use and issues a series of messages that contain monitoring information. For each 
buffer pool, this information includes: 


e Buffer pool ID. 


e Flags (Q or F): Q shows a request is queued for this pool; F shows dynamic 
buffering has failed for this pool. 


e Size of each buffer in this pool. 

e Current total number of buffers in this pool. 

e Current count of buffers available (the number not in use). 

e Largest number of buffers this pool has expanded to at any time. 

e Largest number of buffers in use at any time. 

e Cumulative count of the number of times each buffer pool has expanded. 
e Expansion and contraction thresholds. 


e The expansion increment (the number of buffers to be added to a buffer pool 
during dynamic expansion). 


e VTAM's intermediate routing node buffer use limit (IRNLIMIT), current buffer 
use, and maximum buffer use. 


° VTAM's CSA buffer use limit (CSALIMIT), current buffer use, and 
maximum buffer use. 


. Maximum amount of CSA in use since VTAM was started. 
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° VTAM's SGA buffer use limit (SGALIMIT), current buffer use, and 
maximum buffer use. : | 


e Current amount of VTAM private storage and maximum amount of VTAM 
private storage. 


If the DISPLAY BFRUSE command is used while an SMS (buffer use) trace is 
running, the fields MAX TOTAL, MAX USED, and TIMES EXP reflect buffer usage 
only since the last trace record was written, because the SMS trace resets these 
fields. For more information about the syntax and output of the DISPLAY BFRUSE 
command, see “DISPLAY BFRUSE Command” in VTAM Operation. 


DISPLAY BFRUSE output can help you identify possible sources of problems. The 
following chart shows some problem symptoms and the corresponding buffers to 
check in SMS trace output: 


For this symptom: Check this buffer pool: 
/O hang lIOBUF 

Session failure CRPLBUF and LPBUF 
VTAM hang LPBUF 


_ For information on interpreting DISPLAY BFRUSE output for each type of buffer 
pool, see “Monitoring Common Storage Areas” in the VITAM Network Implementa- 
tion Guide. 


Display NCP Storage 
| You can display any selected portion of NCP storage by using a DISPLAY 
NCPSTOR command. Up to 256 bytes can be displayed for each command. For 
the 3720 or 3745 communication controller, you can also use the DISPLAY 
NCPSTOR command to display up to 256 bytes of an NCP dump or state vector 
stored on the disk. 


VTAM issues message IST2451 to display the storage contents. 


Notes: 


1. The NCP storage to be displayed may change while it is being formatted for 
transmission. 


2. You cannot display NCP storage at a data host, because a data host does not 
own any NCPs. 


For more information on the syntax and output of the DISPLAY NCPSTOR 
command, see “DISPLAY NCPSTOR Command’ in VTAM Operation. 


Display Resource Status 
You can use the DISPLAY ID command to display status information about any 
major or minor node. For example, a request to display a physical unit or a logical 
unit indicates whether that node has been added by dynamic reconfiguration. 
DISPLAY ID also indicates whether a logical unit, a physical unit, or a link is sup- 
ported by the Network Terminal Option (NTO). 


Note: From a data host you cannot display the status of either an NCP or the 
NCP's subordinate resources, because a data host does not own any NCPs. 
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Two types of node status are displayed when you use the DISPLAY ID command: 


The STATUS field shows the current state of the node 
The DESIRED STATE field shows the desired state. 


The desired state is the condition that VTAM processing is attempting to establish 
for the node. Previously entered operator commands or recovery processing may 
establish the desired state for a node. When processing is completed, the desired 
state and the current state should be the same. See “Resource State Code 
Values” in VITAM Messages and Codes for descriptions of the resource status 
codes used in response to the DISPLAY ID command. 


If SNA network interconnection is in use, the DISPLAY command shows: 
e The network ID associated with a resource (if any) 


e For a cross-network CDRSC, the real resource name 


e For a cross-network CDRM, the real name of the gateway node through which 
the SSCP-SSCP session passes, and the network address as known in the 
requesting host's network. 


Display Path Tables 
This is the place to start when route problems are detected. This display provides 
information about the route status known by this host VTAM. 


You can use the DISPLAY PATHTAB command to display the status of explicit 
routes and their associated virtual routes for a local host. You can display informa- 
tion about all routes or you can limit the information using the ADJSUB and 
DESTSUB operands. The resulting display shows the host path table contents. 


For more information on the syntax and output of the DISPLAY PATHTAB 
command, see “DISPLAY PATHTAB Command” in VTAM Operation. 


Display Resources in a Pending State 
You can use the DISPLAY PENDING command to display information about 
resources in the domain that are in one of the following pending states: 
e Transient state to or from a fully active state 


e State of “recovery pending” or “recovery in progress” for application programs 
suspended because of the failure or takeover of an application program 
enabled for persistence. You must enter the DISPLAY PENDING command 
on the system in which the application program resides. 


The resource can be a major node, a minor node, an application program, a phys- 
ical unit, or a logical unit. 


For more information on the syntax and output of the DISPLAY PENDING 
command see, “DISPLAY PENDING Command” in VTAM Operation. 
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Display Route Status 
The DISPLAY ROUTE command shows the status and availability of virtual and 
explicit routes. VTAM displays the status of selected routes and, if TEST=YES is 
specified, does a route test on the routes selected in the DISPLAY command. (See 
“Display Route Test” on page 205.) The VTAM operator may select the origin of 
the routes to be displayed or tested. The origin may be either a host processor or 
an NCP. 


For more information on the syntax and output of the DISPLAY ROUTE command, 
see “DISPLAY ROUTE Command” in VTAM Operation. 


For a sample path problem, see “Example: Solving Path Problems” on page 199. 


The display of status for the routes selected is formatted as shown in Figure 23. 


Displaying one explicit route to a destination subarea: 

d net, route, destsub=01, netid=netc, origin=a03n43a, er=5 
ISTQ097I DISPLAY ACCEPTED 

IST535I ROUTE DISPLAY 7 FROM SA 4 TO SA 1 

IST808I ORIGIN PU = CQ453LE DEST PU = COINPU NETID = NETC 


IST536I VR TP STATUS ER ADJSUB TGN STATUS CUR MIN MAX 
IST5371 0 0 ACTIV 5 1 1 ACTIV3 
IST5371 0 1 INACT 5 1 1 ACTIV3 
IST5371 0 2 INACT 5 1 1 ACTIV3 


IST314I END 
Figure 23. Example of DISPLAY Route Status Output 


If you are using SNA network interconnection, the DISPLAY ROUTE 
command can be used to show the status and availability of adjacent VTAM net- 
works. The resulting display is the same as shown in the previous example, except 
that message IST808I contains an additional field, NETID=netid, to show the ID of 
the adjacent network. 


See VTAM Messages and Codes for a complete description of the variable data 
contained in the messages that result from the DISPLAY ROUTE command. 


It is possible for the test results for an explicit route to be lost before they are dis- 
played. For example, if a node or a link along the explicit route fails between the 
time the test request flows outbound and the time the test results flow inbound, the 
results will be lost. If this occurs, re-enter the DISPLAY ROUTE command for that 
explicit route. 


Note: You can use the NetView session monitor to collect more information about 
routes. If all the required session monitors along the route are in session, you can 
test the entire route, from one session end to the other. See Table 80 on 

page 1165 to determine what book has more information on the NetView session 
monitor. 
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Example: Solving Path Problems 
This example takes you through a sample path problem and show you how to diag- 
nose and solve the problem. It includes the following sections: 


e “Rules for Routing” 

¢ “Configuration and Situation” 

e “Analyzing the Problem” on page 200 

e “Finding the Problem” on page 200 

e “Steps for Displaying Routes” on page 200 
e “Fixing the Problem’ on page 203 

e “Dynamic Path Update” on page 203 

e “Coding the Path in the NCP” on page 204. 


Rules for Routing: The rules that you need to keep in mind when working with 
routes are: 
e Virtual routes must end in the subareas where the session end points reside. 


e Virtual route numbers must be defined the same in both directions but only at 
each end point. A virtual route definition does not need to be specified in every 
node in the path. 


e Explicit routes do not have to flow in both directions, but must be the same in 
one direction from endpoint subarea to endpoint subarea. 


e Explicit and virtual route rules apply in each network, not across SNI network 
boundaries. 


e Transmission group numbers on the VR that you are using must be the same 
in both directions, but only between two nodes, not along the entire path. 


Configuration and Situation: Following is the configuration: 


CP-CP 
Session 


Subarea 500 Subarea 15 


Host01 


OOOOH 


Subarea 310 


Figure 24. Path Problem Example Network Configuration 
The situation is: 


e Host0O1 is a network node and has a CP-CP session with Host02. 
e Host15 and Host500 are subarea data hosts. . 
e You need a session from APPL1 to APPL15. 
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e The session is failing with a path problem sense code (8013xxxx). 


Analyzing the Problem: Since Host01 is an APPN node, the route does not end 
in Host01; it ends in subarea 4 (AO4NCP). The route must follow the path: subarea 
4 (AO4NCP) to 310 (A310NCP) to 500 (Host500) to 15 (Host15) and back. 


Following the rules for routing, you need the following for this session: 


e One virtual route number going from Host500 to AO4NCP. 
e One explicit route number going from Host15 to AO4NCP. 
e One explicit route number going from AO4NCP to Host15. 


Finding the Problem: To find the problem, you must first display the routes 
across your session path. Then, you need to map the information that you received 
from the displays to locate the problem. 


Steps for Displaying Routes: You can display the routes between the subareas 
in your routes to identify the problem area. 
Note: Displays shown are abbreviated. If you run this display on your system, it will list information for 
all explicit routes from O to 15. 


1. Display the route from Host15 to Host500 with AO4NCP as the destination subarea. From Host15, 
issue the following command: 


D NET, ROUTE, DESTSUB=4 


ISTO97I DISPLAY ACCEPTED 
IST535I ROUTE DISPLAY 1 FROM SA 15 TO SA 4 225 
IST808I ORIGIN PU = ISTPUS DEST PU = AO4NCP NETID = NETA 


IST5361 VR TP STATUS’ ER ADJSUB TGN STATUS CUR MIN MAX 
IST5371 | 0 3 1 INOP 

IST5371 1 © ACTIV 1 500 2 ACTIV3 7 5 15 
IST537I 1 1 INACT° 3. 1 500 = 2s ACTIV3 

IST537I 1 2 ~~ ACTIV 1 500 2 ACTIV3 12 5 15 
IST537I 3 ©  INACT 2 500 1 INOP 

IST5371 5 ©  INACT 3 30 1  INOP 

IST5371 5 1 INACT 3 30 1  INOP 

IST537I 5 2 £4zACTIV. 3 30 1  INOP 

IST5371 6 ©  INACT 6 500 =6.1-) =CACTIV3 

IST537I 6 1 INACT 6 500 1 ACTIV3 

IST5371 6 2 ~~ ACTIV 6 500 1 ACTIV3 23 15 45 
IST5371 15 UNDEF 


IST3141 END 
From subarea 15 to subarea 500, you have ER1, ER2, and ER6 defined. 


=" = 
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2. Display the route from Host500 to A310NCP with AO4NCP as the destination subarea. From Host500, 


issue the following command: 
D NET, ROUTE, DESTSUB=4 
ISTO97I DISPLAY ACCEPTED 


IST5351 ROUTE DISPLAY 1 FROM SA 500 TO SA 4 


IST808I ORIGIN PU = ISTPUS DEST PU = AQ4NCP NETID = NETA 
ADJSUB TGN 


IST5361 VR TP STATUS 
IST5371 

IST537I 1 0 ACTIV 
IST5371 1 1 INACT 
IST5371 1 2 ACTIV 
IST5371 2 0 ACTIV 
IST5371 6 9Q INACT 
IST5371 6 1 INACT 
IST537I 6 2 ACTIV 
IST5371 7 0 INACT 
I$T5371 


IST3141 END 


—_— 


ER 


© 


AInXNIAA A DM ee 


2 
310 
310 
310 
310 
310 
310 
310 
310 


1 


— ee ee -e FW PO RN PAO 


STATUS CUR MIN MAX 
INOP 

ACTIV3) 20 15 45 
ACTIV3 

ACTIV3) 33 15 45 
ACTIV3 9 5 15 
ACTIVI 

ACTIVI 

ACTIV3 7 5 15 
INOP 

UNDEF 


From subarea 500 to subarea 310, you have ER1, ER2, ER6, and ER7 defined. 


310 


aa as a ER1,VR1 


2 


<———————————— FR1,VR1 


4——_—2—__— eno vane <1 Erno ver 


ERS ROG ———!————._ ERG. 


a 9&7 V—R7 


3. Display the route from A310NCP to AO4NCP. From Host500, issue the following command: 
D NET, ROUTE, ORIGIN=A310NCP, DESTSUB=04 


ISTO97I DISPLAY ACCEPTED 


IST535I ROUTE DISPLAY 1 FROM SA 310 TO SA 4 225 
IST8081I ORIGIN PU = A31ONCP DEST PU = AO4NCP NETID = NETA 


IST5361 VR TP STATUS 
IST5371 

IST5371 1 0O INACT 
IST5371 6 0 INACT 
IST537I1 6 1 INACT 
IST5371 6 2 ACTIV 
IST5371] 


IST3141 END 


ER 


—_ 


Nana ane © 


ADJSUB TGN 
2 1 
4 1 
4A 1 
4 1 
4 1 


STATUS CUR MIN MAX 
INOP 

INOP 

ACTIV3 

ACTIV3 

ACTIV3 3 2 6 
UNDEF 


From subarea 310 to subarea 4, you have ER1 and ER6 defined. 


A 


lp 


<«—_1____ 
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ER1.VR1 «@——2——_-. ER, VR1 <->. ER, VR 


2. Eno vRo <q ——__1_—_- Erno. v\~3 


ER6,VR6 <——!—_—_——-. ER6. VR6 <4———_-__—-. Ene. vRG 


~—_1___. ER7,VR7 
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So, you can use either ER1 or ER6 to go from subarea 15 to subarea 4. 
4. Display the route from AO4NCP to A310NCP with Host15 as the destination subarea. From Host02, 
issue the following command: 
D NET,ROUTE, ORIGIN=AO4NCP, DESTSUB=15 


ISTO97I DISPLAY ACCEPTED 
IST535I ROUTE DISPLAY 1 FROM SA 4 TO SA 15 225 
IST808I ORIGIN PU = AQ4NCP DEST PU = A15PU NETID = NETA 


IST536I1 VR TP STATUS ER ADJSUB TGN STATUS CUR MIN MAX 
IST5371 0 2 1 INOP 

IST5371 | UNDEF 

IST5371 7 0 INACT 7 310 1 ACTIV3 

IST5371 7 1 INACT 7 310 1 ACTIV3 

IST5371 7 2 ACTIV 7 310 1 ACTIV3 3 2 6 
IST5371 15 UNDEF 

IST3141 END 


From subarea 4 to subarea 310, you have ER7 defined. 


=e 


ER7.VR7 ————___—__»> 


Ls 


5. Display the route from A310NCP to Host500 with Host15 as the destination subarea. From Host500, 
issue the following command: 


D NET, ROUTE, ORIGIN=A310NCP , DESTSUB=15 


ISTQ971 DISPLAY ACCEPTED 
IST535I ROUTE DISPLAY 1 FROM SA 310 TO SA 15 225 
IST808I ORIGIN PU = A310NCP DEST PU = A15PU NETID = NETA 


IST536I VR TP STATUS ER ADJSUB TGN STATUS CUR MIN MAX 
IST5371 0 2 1 INOP 

IST5371 1 1 INACT 2 500 2 INOP 

IST537I 2 0 INACT 1 500 1 ACTIV3 20 15 45 
IST537I 7 0 ACTIV / 500 1 ACTIV3 29 20 60 
IST5371 7 1 ACTIV 7 500 1 ACTIV3 

IST537I 7 2 ACTIV / 500 1 ACTIV3 40 20 60 
IST5371 15 UNDEF 


IST314I END 
From subarea 310 to subarea 500, you have ER1, ER2, and ER7 defined. 


1 


ER7.VR7 —_——— ER7.VR7 ———_—_»> 


ER1,VR2 —————_____»> 


ER2,VR1 ————_>—_» 
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6. Display the route from Host500 to Host15. From Host500, issue the following command: 
D NET, ROUTE, DESTSUB=15 


TSTO971 DISPLAY ACCEPTED 
IST535I ROUTE DISPLAY 1 FROM SA 500 TO SA 15 225 
IST808I ORIGIN PU = ISTPUS DEST PU = A15PU NETID = NETA 


IST5361 VR TP STATUS ER ADJSUB TGN STATUS CUR MIN MAX 
I$T5371 0 2 1 INOP 

IST5371 1 1 INACT 2 15 2  INOP 

IST5371 4 0 INACT 5 310 1 INOP 

IST5371 4 1 INACT 5 310 1 INOP 

IST537I 4 2 INACT 5 310 1 INOP 

IST537I 7 0 INACT 7 15 1 ACTIV3 7 § 15 
IST5371 7 1 INACT 7 15 1 ACTIV3 

IST5371 7 2 ACTIV 7 15 1 ACTIV3 35 20 60 
IST5371 15 UNDEF 


IST3141 END 
From subarea 500 to subarea 15, you have ER2 and ER7 defined. 


=" x 


ER7,VR70.———-—_——» ER7,VR7, ———_—_———> ER7.vR7 ————____»> 


ER VR —————— 


ER2,VR1 ———*—___» ER? VR1 ——__2>-_» 


Fixing the Problem: Here is what your routing looks like now: 


g——__)— ERIVR1 q——— 2 Ent vat q————_ 2 Ern.vr1 
<q—_—_2—— enor vrn2 <——_1+_—- Enon 
Ene. vr6 q————!_—_—_- ere.vre <———__——-. ern. vne 


$$ £97,:Vh—F7 


ER7,VR7 $< £R7,VA7 ——_——_— £A7,vhA7 ———_—__|_____» 


ER1,VR2. ——————______» 


ER2,VR1 ————2———» ER2.VR1 —————2-—___»> 


From these examples, you can see that the easiest way to fix the problem is to define ER2 from subarea 
4 to subarea 310 and map VR1 to ER2. You can do this dynamically using dynamic path update, or you 
can change the NCP generation. 
Dynamic Path Update: To fix this problem using dynamic path update, define 
ER2 and map VR1 to ER2. 


Warning: Whenever you are making a change in paths, make sure that you are 
not deleting a path that you need for another route. Following is the NCPPATH 
statement that defines the new path. 


AO4NCP NCPPATH NETID=NETA 
P002 PATH DESTSA=310, ER2=(310,1) ,VR1=2 
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To change the path, use the VARY ACT command to activate your dynamic path 
update member. 


Note: If this was a problem from a host to another subarea, you would use a 
VPATH definition to fix the problem 


Coding the Path in the NCP: In the NCP generation, find the path for destination 
subarea 310: 


PATH DESTSA=310, 
ERO=(2,1),ER1=(71,80), 
ER3=(2,1) , ER4=(3,80) , ER5=(310,80) , 
ER6=(310,80) ,ER7=(310,1) ,ER8=(71,80), 
ER9=(2,1),ER10=(1,1),ER11=(400,80), 
ER12=(1,1), 
VRO=6, 
VRPWSOO=(1,3) , VRPWSO1=(1,3) , VRPWSO2=(1,3), 
VR1=9, 
VRPWS10=(2,6) , VRPWS11=(2,6) , VRPWS12=(2,6), 
VR2=3, 
VRPWS20=(2,6) , VRPWS21=(2,6) , VRPWS22=(2,6), 
VR3=8, 
VRPWS30= (2,6) , VRPWS31=(2,6) , VRPWS32=(2,6), 
VR4=4, | 
VRPWS40=(2,6) , VRPWS41=(2,6) , VRPWS42=(2,6), 
VR5=11, 
VRPWS50=(2,6) , VRPWS51=(2,6) , VRPWS52=(2,6), 
VR6=10, 
VRPWS60=(3,9), VRPWS61=(3,9) , VRPWS62=(3,9), 
VR7=7, 
VRPWS70= (3,9), VRPWS71=(3,9) , VRPWS72=(3,9) 


Change the definition for ER2 to destination subarea 310 and TGN1 and map VR1 
to ER2: 
PATH DESTSA=310, 
ERO=(2,1) ,ER1=(71,80) , ER2=(310,1), 
ER3=(2,1) ,ER4=(3,80) ,ER5=(310,80), 
ER6=(310,80) ,ER7=(310,1) ,ER8=(71,80), 
ER9=(2,1) ,ER10=(1,1) ,ER11=(400,80), 
ER12=(1,1), 
VRO=6, 
VRPWSO0= (1,3) , VRPWSO1=(1,3) , VRPWSO2=(1,3), 
VR1=2 
VRPWS10=(2,6) , VRPWS11=(2,6) , VRPWS12=(2,6), - 
VR2=3, 
VRPWS20= (2,6) , VRPWS21=(2,6) , VRPWS22=(2,6) , 
VR3=8, 
VRPWS30= (2,6) , VRPWS31=(2,6) , VRPWS32=(2,6) , 
VR4=4, 
VRPWS40= (2,6) , VRPWS41=(2,6) , VRPWS42=(2,6), 
VR5=11, | 
VRPWS50= (2,6) , VRPWS51=(2,6) , VRPWS52=(2,6), 
VR6=10, | 
VRPWS60= (3,9) , VRPWS61=(3,9) , VRPWS62=(3,9), 
VR7=7, 
VRPWS70=(3,9) , VRPWS71=(3,9) , VRPWS72=(3,9) 
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Warning: Whenever you are making a change in paths, make sure that you are 
not deleting a path that you need for another route. 


Display Route Test 
If a route test was requested, results of the test are sent asynchronously to the 
console of the operator requesting the display. !f the route test failed, the results 
are also sent to the console of the host that owns the rejecting subarea node. If 
the host owning the rejecting subarea is the same host that initiated the route test, 
that host will receive the test results twice. 


To be tested, the explicit route must be known to VTAM. This means the explicit 
route must be defined to VTAM, or at some time must have been operative. 


Successful Route Test 
If TEST=YES is set and the route test is successful, the following asynchronous 
messages follow the route status display messages previously described. 


The test results are formatted as shown in Figure 25. 


IST5381 ROUTE TEST ### IN PROGRESS 
IST533I. ER n SUCCEEDED IN ROUTE TEST ### 


IST797I FROM VIA ADJACENT DEST ER LENGTH 
IST6441 fftfffftf TG aaaaaaaa dddddddd 

IST534I sss t XXX yyy 1 
IST7981 nnnn 


Figure 25. Output of a Successful Route Test 


In this example, 


e ffffffff is the name of the origin physical unit. 

¢ aaaaaaaa is the adjacent node. 

e dddddddad is the name of the destination physical unit. 
e sss is the subarea number of ffffffff. 

e tis the transmission group number. 

° xxx is the subarea number of aaaaaaaa. 

e yyy is the subarea of dddddddd. 

e 1 is the explicit route length. 

e nnnn is the network ID of the node being displayed. 


Failed Route Test 

If the explicit route test fails because VTAM is unable to send the Explicit Route 
Test RU into the network, a message tells why the test cannot be performed. This 
message is shown in the following example. 


IST5101 ROUTE TEST ### FAILED - reason 


If the explicit route test is initiated by VTAM but fails, the messages in Figure 26 on 
page 206 show the reason for the test failure. 
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IST533I ER 0 FAILED IN ROUTE TEST 
1ST797I FROM VIA 
IST6441 fffftttf TG 
IST534I SSS t 
IST798I nnnn 

IST572I ~ REJECTING TG 
IST816I rrr 


IST5231 <ER NOT DEFINED> 
<A REQUIRED TG IS INACTI 
<ER NOT REVERSIBLE> 
<ER EXCEEDS MAXIMUM LENG 


8 

ADJACENT 

aaaaaaaa 
XXX 


ADJACENT 
22ZZ 


VE> 


TH> 


<MIGRATION ER NOT SUPPORTED> — 
<MIGRATION NODE DOES NOT SUPPORT THIS ER> 


<MIGRATION NODE ENCOUNTE 
<UNEXPECTED TYPE BYTE X' 


RED> 
##'> 


Figure 26. Output of a Failed Route Test 


In this example, 
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DEST ER LENGTH 
dddddddd 
yyy 


ER MASK 
mmmm 


e ffffffff is the name of the physical unit which originated the ER_TEST. 
° aaaaaaaa is the adjacent physical unit. 
e dddddddd is the name of the destination physical unit. 


e sss is the subarea number of ffffffff. 
e tis the transmission group number. 


e xxx is the subarea number of aaaaaaaa. 
e yyy is the subarea of dddddddd. 
e nnnn is the network ID of the node being displayed. 


rrr is the rejecting subarea. 


ZzZ is the adjacent subarea. 


g is the transmission group number. 


mmmm is the explicit route mask. 


Location of Failure in a Route Test 

The variable text in message IST523!1 can help you determine which direction the 
route test was going when it failed. There are three possibilities. Either the failure 
is in the adjacent subarea or in the link from the adjacent subarea to the rejecting 
subarea, or the failure is in the rejecting subarea, or the location of the failure could 
not be determined. If the reason is “UNEXPECTED TYPE BYTE X'##',” then the 
location of the failure could not be determined. This condition should not occur. 


If the reason is: 


“A REQUIRED TG IS INACTIVE” 
“MIGRATION ER NOT SUPPORTED” 

“MIGRATION NODE DOES NOT SUPPORT THIS ER” 
“MIGRATION NODE ENCOUNTERED” 


the adjacent subarea follows the rejecting subarea in the route being tested. 
Therefore, the problem is in the adjacent subarea or the link to the adjacent 
subarea from the rejecting subarea. (See Figure 27 on page 207.) 
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Possible 
Location 
of failure 


OUTBOUND 


Adjacent 
subarea 


Rejecting 


subarea 


INBOUND 


Direction of Route test 


Figure 27. Route Test Failure (TG Inactive or Migration) 


lf the reason is “ER NOT REVERSIBLE,” “ER EXCEEDS MAXIMUM LENGTH,” or 
“ER NOT DEFINED,” the adjacent subarea precedes the rejecting node in the route 
being tested. (See Figure 28.) 


Check to see if the problem is a path definition error. If not, it may be a VTAM 
error. 


Possible 
location 
of failure 


OUTBOUND 


Adjacent 
subarea 


Rejecting 
subarea 


INBOUND 


Direction of route test 
a 


Figure 28. Route Test Failure (ER Not Reversible, Exceeds Maximum Length, or Not 
Defined) 


The ER MASK field indicates which ER numbers the rejecting subarea can use to 
send data back to the host that requested the test. (These explicit routes are 
called reverse explicit routes.) For example, an ER MASK field of hex 88 (binary 
10001000) means that the 0 and 4 bits of the mask are turned on, so ER numbers 
O and 4 can be used to send data back to the host that requested the test. If 
message IST523I says an explicit route is “NOT REVERSIBLE,” that means the 
rejecting subarea does not have the reverse explicit routes in its path definitions. 


It is possible for the test results for an explicit route to be lost before they are dis- 


played. For example, if a node or link along the explicit route fails between the 
time VTAM sends the test request and the time VTAM receives the test results, the 
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results will be lost. If this occurs, re-enter the DISPLAY ROUTE command for that 
explicit route. 


See VTAM Messages and Codes for complete explanations of the messages 
resulting from the DISPLAY ROUTE command. 


Display Traces 
Use the DISPLAY TRACES command to display the status of a trace for a 
resource and its subordinate nodes. DISPLAY TRACES applies to the following 
types of traces: 


BUF Buffer contents trace 

CNM Communication network management trace 
GPT Generalized PIU trace 

lO Input/output trace 

LINE NCP line trace 

NETCTLR 3710 network controller trace 

SIT Scanner interface trace 

SMS Storage management services buffer use trace 
TG Transmission group trace 

TSO TSO user ID trace 

VTAM VTAM internal trace (VIT) 


See “DISPLAY TRACES Command” in VTAM Operation for information on the 
syntax and output of the DISPLAY TRACES command. 
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Using VTAM MODIFY Commands for Problem Determination 


This section includes the following information: 


“Modify Input/Output Problem Determination” 

“Modify Message Module Identification” on page 210 

“Modify NCP Intensive Mode Recording” on page 210 

“Modify SDLC Link Level 2 Test” on page 211 

“Modify Tuning Statistics” on page 212 

“MODIFY VTAMOPTS Command for Changing Start Option Values” on 
page 212. 


See VTAM Operation for additional information on VTAM commands. 


Modify Input/Output Problem Determination 
The input/output problem determination (IOPD) facility detects pending I/O requests 
when VTAM has sent a request to another part of the network and no response 
has been received after a certain period of time (determined by the IOINT start 
option). The IOPD facility issues IST530! or IST1278I, 1ST1051!, and IST1062I for 
each operation that has been pending longer than the specified time interval. 


These messages include a 10-character I/O operation identifier (usually an RU 
name or operator command), the names of the origin and destination nodes, 
the name of the node for which I/O is pending, and the event ID and event 
code associated with the I/O operation. 


See the explanation of message IST530! or IST12781 in VTAM Messages and 
Codes for a description of these messages. For more information on event. 
codes and IDs, see Chapter 18, “Wait State Event Codes and IDs” in VTAM 
Messages and Codes. 


These messages are only an indication that a problem may exist. The longer 
an operation remains pending (for example, the more messages issued for the 
same request unit), the more likely it is that a problem exists. See “Wait” on 
page 67 for more information on identifying pending I/O problems. 


To enable the IOPD facility, use the MODIFY |OPD command, the IOINT start 
option, or the MODIFY VTAMOPTS command. The value of the IOINT start option 
can be changed using the MODIFY VTAMOPTS command. 


For more information on this command, see “MODIFY VTAMOPTS Command 
for Changing Start Option Values” on page 212. 


For information on the MODIFY |OPD command, see “MODIFY IOPD 
Command” in VTAM Operation. 


For information on the IOINT start option, see “IOINT” in the VTAM Resource 
Definition Reference. 


Note: During initialization of a large VTAM network, you may see more pending 


I/O operations than usual. If you are using the IOPD facility to track I/O 
problems during initialization, the number of message groups issued can 
degrade your network's performance. 


You can use the I[OMSGLIM start option to instruct the IOPD facility to write 
just one message group for each type of pending I/O operation, rather than 
one group for each operation. The resulting reduction in the number of 
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messages issued can improve your network's performance during initializa- — 
tion. 


See “IOMSGLIM” in the VTAM Resource Definition Reference for more 
information on the IOMSGLIM start option. 


Modify Message Module Identification 
You can choose to include in VTAM messages the last five characters of the VTAM 
module that issued the message. The module name abbreviation appears between 
the message ID and the beginning of the message text. To insert or delete module 
name abbreviations, use the MODIFY MSGMOD command, the MSGMOD start 
option, or the MODIFY VTAMOPTS command. 


Specifying MSGMODE=NO stops the insertion of module IDs into messages. 
MSGMODENO is the default. The issuing module name does not appear in mes- 
sages unless MSGMOD=YES is specified in either one of the MODIFY commands 
or in the MSGMOD start option. 


e For more information on the MODIFY MSGMOD command, see “MODIFY 
MSGMOD Command” in VTAM Operation. 


e For more information on the MSGMOD start option, see “MSGMOD?” in the 
VTAM Resource Definition Reference. 


e For more information on the MODIFY VTAMOPTS command, see “MODIFY 
VTAMOPTS Command for Changing Start Option Values” on page 212. 


For example, VTAM message xxxxx (where Xxxxx is an ene system-unique 
message number) normally appears as: 


Xxxxx DUMP OF ncpname COMPLETE 


lf you specify MSGMOD=YES in either the MODIFY MSGMOD command or the - 
MSGMOD start option, the message appears as: 


xxxxx INFXI DUMP OF ncpname COMPLETE 


Notes: 


1. Any message that exceeds the maximum message length after the insertion of 
the module ID is truncated. 


2. If your installation has changed the message text and omitted the message ID, 
the module name is the first item in the message. 


Modify NCP Intensive Mode Recording 


When you receive a large number of temporary errors for a line, but not enough to 
create a permanent error, you can use intensive mode recording to find the cause 
of the error. Intensive mode error recording allows each temporary error over a link 
(and its cause) to be recorded and signaled to VTAM. 


Start intensive mode recording with the MODIFY IMR command. The MODIFY 
IMR command causes the owning SSCP to send a request to the NCP. The NCP 
then builds and sends RECMS RuUs to the SSCP each time an error occurs. The 
SSCP writes these error records on the LOGREC or SYSREC file. 
It can also optionally pass them to a user-defined communication network manage- 
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ment (CNM) application program, such as the NetView program. For more informa- 
tion on the MODIFY IMR command, see “MODIFY IMR Command” in VTAM 
Operation. 


Modify SDLC Link Level 2 Test 
Use the SDLC link level 2 (LL2) test to test the following: 


e SDLC link between an NCP and a physical unit attached on a multipoint line 
e SDLC link between two NCPs. 


° Link between VTAM and any secondary physical unit attached by 
communication adapter SDLC lines. 


By running this test over an extended time, you can increase the possibility of 
repeating an intermittent error that is hard to re-create. 


Note: If you just want to test connectivity to a physical unit, activate the physical 
unit instead of using a link level 2 test. 


To test the link, VTAM sends test data over the link from the controlling NCP to the 
remote station (NCP or peripheral physical unit). The data is then echoed back to 
the sending NCP. This NCP then compares the data received with the data sent 
and forwards the results to VTAM. 


Notes: 


1. For communication-adapter-attached devices, VTAM sends test data over the 
communication adapter attachment to the physical unit. The data is then 
echoed back to VTAM. 


2. VTAM may also receive an LL2 request from an communication-adapter- 
attached NCP, in which case VTAM echoes the data back to the NCP. 


When VTAM receives the test results, it sends message IST549I to the initiating 
console to indicate how the link level 2 test ended: data returned without errors, 
data returned with errors, or no data returned because of an inoperative link or 
initialization error. See message IST5491 in VTAM Messages and Codes for a 
complete message description. | 


When testing the link between an NCP and a peripheral physical unit, the physical 
unit name in the ID operand must be inactive (“dedicated” to the test). Other phys- 
ical units on the same link, however, may remain active. 


When testing the link between two NCPs, the primary link station is the one named 
in the LL2 command, and the secondary link station is the one responding to the 
test. You must start the test from the primary link station. The primary link station 
must be inactive, and the link must be active. 


Start this test with the MODIFY LL2 command. This command causes the SSCP 
to send a test RU to the NCP to which the test terminal is connected. The NCP 
returns test results to the requesting SSCP in a Record Test Results RU. 
The test results include: 

e The number of test frames transmitted by nodename 


e The number of test frames received by nodename 
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e The number of test frames received without error by nodename (that is, suc- 
cessfully returned by the test station). 


If the above three numbers are not the same, that indicates an error in the link or a 
physical unit. Using a line trace might help you further isolate the problem. 


See “MODIFY LL2 Command” in VITAM Operation for more information about the 
syntax of the MODIFY LL2 command. 


Modify Tuning Statistics | 
To record tuning statistics for VTAM, use the TNSTAT start option and include SMF 
in the system during system operation. You can later stop and start the recording 
of tuning statistics with the MODIFY NOTNSTAT and MODIFY TNSTAT com- 
mands. | 


For detailed information about recording tuning statistics and using these statistics 
to improve communication between VTAM and a channel-attached communication 
controller or host processor, see “Gathering Tuning Statistics” in the VTAM Network 
Implementation Guide. For information on the syntax of the MODIFY TNSTAT and 
the MODIFY NOTNSTAT command see “MODIFY TNSTAT Command” and 
“MODIFY NOTNSTAT Command” in VTAM Operation. For information on the 
TNSTAT start option, see “TNSTAT” in VITAM Resource Definition Reference. 


MODIFY VTAMOPTS Command for Changing Start Option Values 
The MODIFY VTAMOPTS command enables you to change certain values that 
may have been specified on VTAM start options. 


For a description of start options that can be changed using this command, see 
“MODIFY VTAMOPTS Command” in VTAM Operation. 
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Chapter 6. Using Dumps 


Using Dumps 


This chapter covers the dumps that you can use for problem determination for the 


VTAM program. The included dumps are: 
e MVS Dumps 


— “Abend Dump” on page 214 

— “FFST Dump” on page 214 

— “Stand-Alone Dump” on page 214 
— “SVC Dump” on page 214. 


e VM Dumps 


— “FFST Dump” on page 215 

— “GDUMP Dump” on page 215 

— “SDUMP Dump” on page 215 

— “DUMP Command” on page 216 

— “VMDUMP Command” on page 216. 


e VSE Dumps 


— “Program-initiated Dump” on page 216 


— “SDAID Dump Facility’ on page 216 


— “Stand-Alone Dump Utility” on page 216 


— “DUMP Command” on page 217. 


e “First Failure Support Technology (FFST) for VTAM (MVS) (VM)” on page 217 


e “Network Control Program (NCP) Dump” on page 227 


e “Communication Scanner Processor (CSP) Dump (3720, 3725, and 3745 Only)” 


on page 230 


Only)” on page 231. 


“Maintenance and Operator Subsystem (MOSS) Dump (3720, 3725, and 3745 


“Formatting and Printing Dump Output (MVS) (VM)” on page 232 describes the 


service aids available for formatting and printing dump output. 
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Dumps on MVS Operating System 


Abend Dump 


_FFST Dump 


Several kinds of dumps can be produced in an MVS system, depending on the type 
of failure and operator action: 


“Abend Dump” 
“FFST Dump” 
“Stand-Alone Dump” 
“SVC Dump.” 


If the appropriate DD card exists, an abend dump is produced when one of the 
following occurs: 


e The operator enters a CANCEL command. 
e An abend macroinstruction is issued. 
e A job abnormally ends. 


To get an abend dump, the input stream for VTAM must contain a DD statement 
with the ddname SYSUDUMP or SYSABEND. The resulting dump is written to the 
data set specified on the SYSUDUMP or SYSABEND DD card. The contents of 
the dump depend on user specifications. See Table 80 on page 1165 to deter- 
mine what book has more information on the abend dump. 


For information on dumps generated by First Failure Support Technology (FFST), 
see “First Failure Support Technology (FFST) for VTAM (MVS) (VM)” on page 217. 


Stand-Alone Dump 


SVC Dump 


The stand-alone dump is produced when the operator invokes the stand-alone 
dump program. This program can be invoked when the operating system is in a 
disabled wait state or looping. The stand-alone dump may be a high-speed dump, 
which is not formatted, or a low-speed dump, which is formatted. The dump output 
is written to the tape or printer (low-speed only) specified on the output operands. 
The output for a high-speed dump can be formatted for viewing by IPCS. See 
Table 80 on page 1165 to determine what book contains more information on the 
stand-alone dump. 


SVC dumps are produced under these conditions: 


e VTAM produces an SVC dump automatically when a program exception occurs. 
VTAM might be terminated as part of this process. The system log indicates 
the location of the dump output and whether the dump was successful. 


e An operator can request a dump with the operating system DUMP command. 
This will not cause VTAM to terminate. 


e An operator uses a SLIP command with ACTION=SVCD specified, and an 
event occurs that matches the trap indicated in the SLIP. 


e A macroinstruction issues an abend, and there is a DD statement with 
ddname=SYSMDUMP. 


e An SDUMP macroinstruction is issued. 
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e System recovery routines produce an SVC dump if VTAM causes an error, 
such as a program exception or abend. 


An SVC dump is written to a SYS1.DUMPnn data set (if allocated), the 
SYSMDUMP output data set, or the data set specified on the DCB operand of the 
SDUMP macroinstruction. An SVC dump can be formatted for viewing by IPCS. 
To determine what book contains more information on SVC dump, see Table 80 on 
page 1165. 


Dumps on VM Operating System 


Several kinds of dumps can be produced in a VM system, depending on the type of 
failure and operator action: 


“FFST Dump” 

“GDUMP Dump” 

“SDUMP Dump” 

“DUMP Command’ on page 216 
“VMDUMP Command” on page 216 


See Table 80 on page 1165 to determine what book contains information on 
dumping CP storage. 


“Formatting and Printing Dump Output (MVS) (VM)” on page 232 tells you how to 
format and print the output. 


FFST Dump 


For information on dumps generated by First Failure Support Technology (FFST), 
see “First Failure Support Technology (FFST) for VTAM (MVS) (VM)” on page 217. 


GDUMP Dump 
The GDUMP command can be entered by the VM system operator. The resulting 
dump can be formatted and printed with the PRTDUMP command of IPCS. The 
VTAM control blocks shown in “PRTDUMP Service Aid (VM)” on page 233 are for- 
matted in a GDUMP. 


Note: For a loop problem, do not use the GDUMP command. Instead, use the 
VMDUMP command. 


SDUMP Dump 


An SDUMP dump is produced automatically when a machine program check or a 
GCS internal error occurs. 


Note: VTAM disables the VIT when it issues SDUMP to prevent the VIT table 
from being overwritten. The resulting dump can be formatted and printed with the 
PRTDUMP command of IPCS. The VTAM control blocks shown in “ABDUMP 
Service Aid (MVS)” on page 232 are formatted in an SDUMP. 
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DUMP Command 


The DUMP command can be entered by the VM system operator. This command 
produces a formatted hard-copy dump. 


VMDUMP Command 


The VM system operator can enter the VMDUMP command in CP mode as follows: 
#CP VMDUMP @:END FORMAT GCS DSS 


The resulting dump can be formatted and printed with the PRTDUMP command of 
IPCS. The VTAM control blocks shown in “PRTDUMP Service Aid (VM)” on 
page 233 are formatted in a VMDUMP. 


CP should have control when you issue this command. That is, you should either 
press PA1 or enter #CP before issuing the VMDUMP command. See “PRIDUMP 
Service Aid (VM)” on page 233 for details on using PRTDUMP. 


Dumps on VSE Operating System 


Several kinds of dumps can be produced in a VSE environment, depending on the 
type of failure and operator action: 


“Program-Initiated Dump” 
“SDAID Dump Facility” 
“Stand-Alone Dump Utility” 
“DUMP Command?” on page 217. 


Note: Dumps produced by canceling VTAM are of limited diagnostic value. Use 
other dump facilities to document a problem before canceling VTAM. 


Program-Initiated Dump 


Customer programs can produce dumps by using system dump macroinstructions 
(PDUMP, JDUMP, DUMP). Other IBM licensed programs, such as CICS/VS, also 
have their own dumping facilities, which may be useful in isolating some VTAM 
problems. 


SDAID Dump Facility 


The dump facility of SDAID is useful when debugging requires a dump of one or 
more specific storage areas on the occurrence of a specific event. The output 
device can be a tape drive or a printer. SDAID output on tape can be printed with 
DOSVSDMP. See Table 80 on page 1165 to determine what VSE books contain 
more information on DOSVSDMP and SDAID. 


Stand-Alone Dump Utility 


A stand-alone dump created with the DOSVSDMP utility is useful when the severity 
of a system malfunction (such as a hard wait state) prevents using other methods. 
DOSVSDMP prints the output of a stand-alone dump. 
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DUMP Command 


The DUMP command causes VSE to produce a dump of the storage area specified 
in the command. The operator can direct the dump either to tape or to a SYSLST 
device. To retrieve the dump information, you can do either of the following: 


e Use DOSVSDMP to have the dump information printed on the printer assigned 
to SYSLST. 


e Load the dumps recorded on the tape into your system's dump library, and use 
Info/Analysis to retrieve the dump information. 


See Table 80 on page 1165 to determine what book describes retrieving dump 
information from tape for VSE. 


First Failure Support Technology (FFST) for VTAM (MVS) (VM) 


FFST Dumps 


First Failure Support Technology is a licensed program that captures information 
about a potential problem when it occurs. See Appendix C, “First Failure Support 
Technology (FFST) Probes (MVS)(VM)” on page 845 for descriptions of the various 
FFST probes. See Table 80 on page 1165 to determine what book contains more 
information on FFST. 


When a problem is detected, a software probe is triggered by VTAM. FFST then 
collects information about the problem and generates output to help solve the 
problem. Based on the options active for the probe you get a dump and a generic 
alert. See “The Generic Alert” on page 223 for information on generic alerts. You 
also get the FFST 'EPW' message group as shown in the “FFST Console” on 
page 224. 


Each VTAM FFST probe can trip up to five times in five minutes before it is auto- 
matically turned off. Only one of the five dumps will be produced, thereby limiting 
the number of dumps that you get if a recurring problem triggers a probe. 


You can get either an SDUMP (full dump) or a FFST minidump (partial dump) 
depending on the characteristics of the probe that is triggered. 


Dump Data Set (MVS) 

FFST saves the VTAM FFST minidump on a dynamically allocated sequential data 
set. The VTAM FFST full dump (SDUMP) is saved on SYS1.DUMPx data sets. 
You must specify the volume serial number and the UNIT identification information 
for this data set. Provide this information to FFST on a DD statement in the FFST 
installation procedure or in the FFST start-up command list installed at system 
installation. A start-up command list contains MVS commands to control FFST. 


SDUMP 

If the SDUMP option has been coded in the probe, FFST uses the operating 
system SDUMP macroinstruction to provide a full dump of the address space 
where the potential problem occurred. 


Formatting an SDUMP: Use the VTAM dump formatter to view or print the full 
dump. If you try to use EPWDMPFM or EPWDMPFV to format a full dump, 
message EPW9561E NOT A VALID FFST DUMP will be issued. 
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FFST Minidump 

If the SDUMP option has not been coded for the probe triggering the dump, a 
FFST minidump is written to the output data set. See Figure 29 on page 219 and 
Figure 30 on page 221. 


The probe output data used for VTAM FFST minidumps are found in the data sets 
that were allocated when VTAM FFST was installed. 


Formatting a FFST Minidump (MVS): Use the dump formatting CLIST, 
EPWDMPF\M, to format your VTAM FFST minidump. EPWDMPFM formats your 
minidump and writes it to a data set that you can view online or print using the 
IEBPTPCH utility program. (FFST minidumps cannot be processed by the VTAM 
formatted dump tool.) 


Formatting a FFST Minidump (VM): Use the VM dump formatter EPWDMPFV to 
format your VTAM minidump. 

1. Use DUMPLOAD to download the dump from OPERATNS. 

2. Run DUMPSCAN against the output from DUMPLOAD. 

3. From the command line of DUMPSCAN, enter EPWDMPFV to format the dump. 
Sample FFST Minidump: See Figure 29 on page 219 and Figure 30 on 
page 221 for a sample VTAM FFST minidump. Figure 29 on page 219 was 


produced when VTAM session services CP-CP (SSC) entered an unexpected state 
_on a contention-winner session. 
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SCUNO - FAILURE ON CONWINNER SESSION 
11/69/92 


EPW95211 DUMP DATA SET NAME = FFSTDS.MVS42247.VTAM. DMP06033 

EPW95221 TITLE FROM OUMP = SCUNO - FAILURE ON CONWINNER SESSION 

EPW95231 DATE FROM DUMP = 16/28/92, TIME FROM DUMP = 12:00:06 

EPW95611 PRODUCT NAME: VTAM 

EPW9562I IBM PROGRAM 

EPW9503I COMPONENT/PROGRAM ID: 569511761, LEVEL: 201 

EPW9504I TYPE OF FAILURE: INCORROUT 

EPW9565I PROBE PRIMARY SYMPTOM STRING: 

PIDS/569511701 LVLS/2@1 PCSS/ISTSCC69 RIDS/ISTSCUNO 

EPW95671I REGISTER SECONDARY SYMPTOM STRING: 

REGS/GR13 VALU/HO68E6098 REGS/GR14 VALU/H868D46CA REGS/GR15 VALU/Hee8e8eGee 
REGS/GR@@ VALU/H868D40CA REGS/GRO1 VALU/H@GS8E6@E6 REGS/GR62 VALU/HO68E6260 
REGS/GRO3 VALU/HO751C86@ REGS/GRO4 VALU/H86BC5A14 REGS/GR@5 VALU/H662D1B88 
REGS/GRO6 VALU/H@OC97EBO REGS/GRO7 VALU/H@0C171F8 REGS/GRE8 VALU/HO68E6078 
REGS/GR@9 VALU/H@6060442 REGS/GR1® VALU/H@68D7B60 REGS/GR11 VALU/H66660061 
REGS/GR12 VALU/H868D3CAA 

G@EPW9508I DATA COLLECTION WORK AREA: 

GASID(X'@012') ADDRESS (660B1600) KEY(6@) 


660B1060. 61604066 G9008000 G50060F8 01000002 |/. ....... -8.... 
666B1016. 668E6698 863A27AG 666054AG O6508ED8 |..-qf........ &.Q 
66681626. C5D7E6C4 E2E3E2D2 66806006 868E6020 |EPWDSTSK...... -. 


06681636. 60006266 8652136A 665204E6 60000001 |-...f...... 5 er 


EPW9509I SPECIFIED DATA STRUCTURE TABLE: 
ASID(X'8012') ADDRESS(86999BE8) KEY(66) 
06999BE8. 77001418 618600F8 
O6999BFO. C9EZE3E2 C3C3C6E3 GOFOFZF2 F5F64040 | ISTSCCFT.92256 
@6999C86. 6666125C 669711F8 EEGGO68CC C9D5C3D6 |...*.p.8....INCO 
06999C16. D9D9D6E4 E3404040 662803F8 60003401 |RROUT ...8....| 


EPW9569I DEFAULT DATA STRUCTURE TABLE: 
ASID(X'@012') ADDRESS (@63859E8) KEY(@0) 


06385968. 7708026C 014060F8 .. 42.8, 
063859F6. C9EZE3D9 CIC3E9E9 E4FOF2F2 F5F64046 | ISTRACZZU92256.. 
@6385A00. 666601F4 60600000 EEOG0044 CODSC3D6 |...4........ INCO 


@6385A10. D9D9D6E4 E3464040 662803F8 10001CG0 |RROUT ...8.... 


EPW9510I AREA AROUND REGISTER © - S68D40CA: 
ASID(X'@012') ADDRESS(@68D3CCA) KEY(00) 
@68D3CCA. C8FA 1805140E | a 
O68D3CD0. 14£41FGE 55004004 47D0CO46 58FOC906 

@68D3CE6. 5816C962 41000086 89060018 16100A0D | 

Q68D3CFO. 182D1838 1£391842 1F550E24 D2e7De00 


EPW9516I AREA AROUND REGISTER 15 - 66000000: 

ASID(X'@012') ADDRESS(60060600) KEY(66) PREFIXED 
66660000. 646C6G08 8122F568 66000008 60000000 |....a.5..... Seal 
66000016. GOFD3AC6 60600006 676C200@ 82667784 |...{.....%..b-.. 
06600026. 676C1666 8@6198DE 676C6060 8639EOB2 |..... -q...-f.\. 
66606630. 676C1066 8003D52A 670CGG06 81E23422 |...... No weee as.. 


VTAM COMMUNICATION VECTOR TABLE 
EPW95201 DATA STRUCTURE DEFINED IN DEFAULT DST 
ASID(X'@812') ADDRESS (60C171F8) KEY (66) 


66C171F8. ESC5F4F2 40464040 VE42 
06C17200. FFF901F4 O5F6D866 60060000 OBOGOFFDS | .9.4.6}....... R 
60C17210. 11280060 60060000 O62FEE88 60000000 |........... Nowe 


60C17220. 66660000 686060000 66C17524 90000000 |......... A.wsese 
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VTAM FFST 


INTERNAL TRACE TABLE HEADER 

EPW9520I DATA STRUCTURE DEFINED IN DEFAULT DST 

ASID(X'0012') ADDRESS(@5F6D000) KEY(00) 

O5F6D000. 00000000 00000000 A682A39A 14648800 |........ wht. .U..| 
05F6D010. A682A398 2717CF0@ O5F6FO40 O5F9EFEO |whtq..... 60 .9.\| 
INTERNAL TRACE TABLE 

EPW9514I EXIT ROUTINE CALLED FOR DATA STRUCTURE 

EPW9520I DATA STRUCTURE DEFINED IN DEFAULT DST 

ASID(X'@012') ADDRESS(@5F6F060) KEY(00) 

O5F6FO60. C6C2D3D2 12001200 69DFF20 86387AFC |FBLK........ 2% | 
O5F6FO7@. 868BBDE2 99000020 EGe0e000 HA00GG0O |f............... | 
O5F6FO80. C7C2D3D2 12601200 O6F46E78 66387840 |GBLK..... 4>...# | 
O5F6FO9G. S68BCEG8 60000046 00000000 60000031 |f...... ......- | 


CONTINUATION OF INTERNAL TRACE TABLE 

EPW95141 EXIT ROUTINE CALLED FOR DATA STRUCTURE 

EPW9520I DATA STRUCTURE DEFINED IN DEFAULT DST 

ASID(X'0012') ADDRESS(@5F6D020) KEY(@60) 

O5F6D020. D7C9E449 12990000 66368CF8 49000902 |PIU .r..... 8... 
05F6D030. 200007FC @00001F4 90000136 1C000001 |....... Beccceces 
O5F6D040. D7C9E4F2 0306010A 00100380 O@C4C1E3 |PIU2......... DAT | 
O5F6D050. C14@C1F3 FIC4F9F2 CiF5ee0e@ eoe0000e |A A31D92A5...... | 


SCDAT - SSC PROCESS DATA 
ASID(X'0012') ADDRESS(062D1B88) KEY(0@) 
062D1B88. E2C3C4E3 99000000 | SCOT cc 
06201890. CO@00088 O6A37020 O6A37138 068259F8 
062D1BA0. 00041166 He0ege00 GOGHGNLe GO000000 |..............4. | 
062D1BB6. 90000000 Ge000000 06543018 ae0ccee0 
062D1BCO. 90000000 0751Ce0e eoebe0e0 O6A37020 
062D1BD@. 60C3D7E2 E5C3D4C7 40000000 e9000000 |-CPSVCMG ....... | 
O62D1BE@. 900C12C1 eee90900 FEBEGR0G eQ0ge0eO |...A....6....... | 
062D1BFO LENGTH(1040)==>A1] bytes contain X'6@' 
RUPE - REQUEST UNIT PROCESSING ELEMENT 
ASID(X'@012') ADDRESS(0751C6G6) KEY(06) 
0751C000. 54136004 Be9e008e eOeded0e eeQeeeE | 
0751C016. ae00e000 GEG00000 GOE00R00 FDC3D7E2 pee CPS 
| 


eseereeeeeseaereeos 


ee” eeeereeeeseos 


07510620. 60000000 D5SC5E3C1 4BC1F8F1 05404049 
07510030. 40404040 40404040 40494940 49000000 
0751C04@ LENGTH(16)==>A1ll bytes contain X'00' 
0751C050. O68E5E68 0088000 40060080 98004004 |..; 

0751C060. eeg9eeGe BEGHEGGG GOG0GG08 B6BC5A14 | ahcerendia se ieeetabel 
6751C078. e6000000 O81CE002 eOeGG00e eQQQ0008 

0751C680 LENGTH(16)==>All bytes contain X'00' 

07510698. 90000000 Peer | 
IPS - INTER PROCESS SIGNAL 

ASID(X'@012') ADDRESS(@6BC5A14) KEY(@0) 

06B8C5A14. O440FDC3 D7E202D5 C5E3C14B | =. .CPS.NETA.| 
O6BC5A20. C1F8F1D5 40464040 40404640 eoeeeoee |ABIN : 

O6BC5A30. 80090000 66000300 8005081C 60021400 |................ 

O6BC5A40 LENGTH(104@)==>All bytes contain X'00' 

O6BC5E50. 60000000 6000 leseawee | 
ANDCB - ADJACENT NODE CONTROL BLOCK 

OASID(X'@012') ADDRESS (@6A37020) KEY(00) 

66A37020. C1D5C3C2 D5C5E3C1 48C1F8F1 05404040 |ANCBNETA.AS1N | 
06A37030. 46404049 49000000 G0000009 C3D7EZE5 | _—=s.......j cpsv| 
06A37040. C3D4C740 e@eoe0e00 GOGGGe0e HAG0G0G0 |CMG ........... ‘| 
06A37050 LENGTH(80)==>Al1 bytes contain X'0@' 

06A370A0. 80000000 62060000 80000000 06862138 |................ | 
06A370B0 LENGTH(16)==>All bytes contain X'00' 
66A370CO. 6751BE20 Eee9e0a0 8200008 eAenGdED | 

06A370D@. 0751BECO ebe900G0 eOeGe0e SA0eGeER | 

06A370E£6. 60000000 16FO1002 62000000 8751C1E0 

06A370FO. 01000000 Ge0eNGeO eOGeCGO HQQOGOGO |................ 
06A37100. e0000000 GGA000G0 G0A00008 AO8O1010 | 

06A37110. 99000000 GO000G08 O6BB9608 He0e000 | 

06A37120. 9990000 BOG00G08 HOG0GG00 00 
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EPW9522I TITLE FROM DUMP = VTAM/FFST MINI DUMP ACTIVE 
EPW9523I DATE FROM DUMP = 09/02/94, TIME FROM DUMP = 09:57:57 
EPW95011 PRODUCT NAME: VTAM VM/ESA V4R2 

EPW95021 IBM PROGRAM 

EPW9503I COMPONENT/PROGRAM ID: 565401001, LEVEL: 420 

EPW9504I TYPE OF FAILURE: INCORROUT 

EPW9505I PROBE PRIMARY SYMPTOM STRING: 

PIDS/565401001 LVLS/420 PCSS/ISTTESTM PCSS/MINI 

EPW9507I REGISTER SECONDARY SYMPTOM STRING: 

REGS/GR13 VALU/HO17BDA77 REGS/GR14 VALU/H817BD11A REGS/GR15 VALU/H00000000 
REGS/GROO VALU/H80000000 REGS/GRO1 VALU/HO17BD784 REGS/GRO2 VALU/H01943800 
REGS/GRO3 VALU/H@1608A90 REGS/GRO4 VALU/HOOOOBFBD REGS/GRO5 VALU/HO101BF00 
REGS/GRO6 VALU/HOOOOBFBD REGS/GRO7 VALU/H00484330 REGS/GRO8 VALU/H00484000 
REGS/GRO9 VALU/HO0000032 REGS/GR10 VALU/HO17BDB30 REGS/GR11 VALU/HO17BCFFF 
REGS/GR12 VALU/H817BC000 

VTAM COMMUNICATION VECTOR TABLE 


DISPLAY 00484000 ~—«wF80 


00484000 
00484010 
00484020 
00484030 
00484040 
90484050 
00484060 
00484070 


00484F10 
00484F20 
00484F30 
00484F 40 
00484F50 
00484F60 


E5C1F4F2 
00000000 
01001750 
0048432C 
11280000 
00000000 
6C280000 
11400000 


010018A0 
00000000 
00000000 
00000000 
00000000 
80000000 
00000000 


40404040 
Q0G0BFBD 
00000000 
00498010 
00000000 
00000000 
00000010 
00000000 


815FFAD8 
00000000 
01410818 
00000000 
00484F80 
00000000 
00000000 


QOOOFFFD 
11280000 
80000000 
13200000 
01001750 
00484204 
90000000 
01001750 


96000000 


00000000 
00000000 
0069E18C 
00000000 
00000000 
00000000 


Q04CE020 66 *VA42 


090000000 
80000000 
00000010 
00000000 
00000000 
814F5AA8 
00000000 


00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


eeoeeseeeespoeeeeeeosn 


e@eeenvneveseeese 


00484F70 
INTERNAL TRACE TABLE HEADER 
DISPLAY 004CE020 20 


Q04CE020 00000000 00000000 
@04CE030 AQDIDD8F 9F9D8800 


AIDIE3E2 
004D3C20 


CFQA8701 6E *...... .-ZJTS..g.* 
00517FEO *ZJ 0.6 Mae (eece” 


INTERNAL TRACE TABLE 
EPW9514I EXIT ROUTINE CALLED FOR DATA STRUCTURE 


EPW95241 DATA STRUCTURE GREATER THAN 65504 BYTES. OUTPUT BEING SPLIT UP. 


EPW9522I TITLE FROM DUMP = VTAM/FFST MINI DUMP ACTIVE 
EPW9523I DATE FROM DUMP = 09/02/94, TIME FROM DUMP = 09:57:57 
EPW9501I PRODUCT NAME: VTAM VM/ESA V4R2 

EPW9502I IBM PROGRAM 

EPW9503I COMPONENT/PROGRAM ID: 565401001, LEVEL: 420 

EPW9504I TYPE OF FAILURE: INCORROUT 

EPW9505I PROBE PRIMARY SYMPTOM STRING: 


PIDS/565401001 LVLS/420 PCSS/ISTTESTM PCSS/MINI 


Figure 30 (Part 1 of 3). Sample FFST Minidump 
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VTAM FFST 


DISPLAY 00484000 


00484000 
00484010 
00484020 
00484030 
00484040 
00484050 
00484060 
00484070 


00484F10 
00484F20 
00484F30 
00484F40 
00484F50 
00484F60 
00484F70 


DISPLAY 004CE020 


E5C1F4F2 
00000000 
01001750 
0048432C 
11280000 
00000000 
0C280000 
11400000 


010018A0 
80000000 
00000000 
00000000 
00000000 
00000000 
00000000 


20 


VTAM COMMUNICATION VECTOR TABLE 


F80 


40404040 
QO0OBFBD 
00000000 
00498010 
06000000 
00000000 
06000010 
00000000 


815FFAD8 
90000000 
01410818 
00000000 
00484F80 
00000600 
00000000 


INTERNAL TRACE TABLE HEADER 


Q04CE020 60000000 00000000 
Q04CE030 ASDIDD8F 9F9D8800 


DISPLAY 004D3C40 


004D3C40 
004D3C50 
004D3C60 
004D3C70 
04D3C80 
004D3C90 
004D3CA0 
004D3CBO 
004D3CCO 
004D3CD0 
004D3CE0 
Q04D3CFO 
004D3D00 
004D3D10 
064D3D20 
004D3D30 


222 VTAM V4R2 Diagnosis 


INTERNAL TRACE TABLE 


E2C3C8C4 
81410AAA 
C1C4E2D7 
06000000 
D9C5D8E2 
806F9562 
C4E2D700 
00000000 
C3C3C900 
81410A60 
D8E4C558 
806B141A 
C5E7C9E3 
81410858 
D9CS5D3E2 
80Q6F95DA 


FFEO 


43202800 
00000000 
43000000 
00484050 
43170000 
00010000 
4300A800 
00000000 
43588000 
90000000 
43482400 
014126F0 
43000010 
80000000 
43170000 
80000000 


QGOOFFFD 
11280000 
80000000 
13200000 
01001750 
004842D4 
90000000 
01001750 


00000000 
00000000 
00000000 
0069E18C 
0000000 
00000000 
00000000 


AODIE3E2 
004D3C20 


01001750 
C9D5E3D4 
01001750 
80000000 
01001750 
0101BD98 
01001750 
C9DSE3D4 
00498228 
58588000 
01001750 
EZE2E6E4 
01001750 
C9D5E3D4 
01001750 
01018098 


EPW95071 REGISTER SECONDARY SYMPTOM STRING: 
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REGS/GR13 VALU/HO17BDA77 REGS/GR14 VALU/H817BD11A REGS/GR15 VALU/HO0000000 
REGS/GROO VALU/H8G000G0@ REGS/GRO1 VALU/HO17BD784 REGS/GRO2 VALU/H01943800 
REGS/GRO3 VALU/HO1608A9@ REGS/GRO4 VALU/HOGOOBFBD REGS/GROS VALU/HO101BF00 
REGS/GRO6 VALU/HOOOOBFBD REGS/GRO7 VALU/H@0484330 REGS/GRO8 VALU/H00484000 
REGS/GRO9 VALU/HO000G032 REGS/GR1@ VALU/HO17BDB30 REGS/GR11 VALU/HO17BCFFF 
REGS/GR12 VALU/H817BC000 


0O4CE020 66 *VA42 si... <..* 
Yel) 1: ¢] (er * 
BOQ0000G «= *. Bee e eee eee * 
00000010 9 *. eee cence * 
00000000 3=—s_ *........ ee Bee. e* 
00000000 =... . . see M..ee* 
SI4F5SAAB — ¥.  e eee eee a|.y* 
00000000 = 3=s *.-—«.. . es Besse 
00000000 * we © eee * 
QO000000 =... cee eee ence * 
QOCQOOO00 =. cece cece eee * 
YT <)¢]]:)( * 
00000000 =... | ene ee eee * 
OOOO0000 = cece e eee * 
OOODQC0O == kL. cece ee eee * 
CFOA8701 GE *........ zJTS..g.* 
OO517FE@  *zJ....h..(...."6 


EPW9514I EXIT ROUTINE CALLED FOR DATA STRUCTURE 


EPW9524I DATA STRUCTURE GREATER THAN 65504 BYTES. OUTPUT BEING SPLIT UP. 


00484050 6E *SCHD....... &.. &e 
00000000 *Acccceee INTM....* 
06000000 *ADSP.....0- B26. 
00000000 Keecces Gecescoes * 
00498610 *REQS.. cee &... 
60000000 TN. weccces Geoee® 
00484050 *DSP...y....&.. &e 
00498010 Weecccene INTM....* 
00000000 BCCI. wc eee De veee * 
00000000 WA. mec cccceceenn * 
00484710 *QUE........ &....* 
00498010 Weyecces OTSWU * 
00484050 HEXIT. cc 200s &.. &e 
00498010 BAe crcece INTM * 
00498010 *RELS....... &....% 
00000000 oI. covvces Geoee® 


Figure 30 (Part 2 of 3). Sample FFST Minidump {Jj 
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004D3B80 
004D3B90 
004D3BA0 
004D3BB0 
004D3BC0 
004D3BD0 
004D3BE0 
004D3BF0 
004D3C00 
004D3C10 
004D3C20 
004D3C30 


VTAM MODULE 


DISPLAY 00484F80 


00484F80 
00484F90 
00484FA0 
00484FBO 
00484FCO 
00484FDO 
00484FE0 
00484FFO 
00485000 
00485010 
00485020 
00485030 
004850640 
00485050 
00485060 


00486020 
00486030 
00486040 
00486050 
00486060 
00486070 
00486080 
00486090 
00486DA0 
00486DB0 
00486DC0 


00486DD0 
00486DE0 
00486DFO 
00486E00 


00487F50 
00487F60 
00487F70 


C6C2D3D2 
8143B3CC 
E6C1C9E3 
8143D842 
D9CS5D8E2 
806F9562 
C4E2D700 
01943800 
5C5C5C5C 
C4C57ED5 
5C5C5C5C 
C440C6D6 


LIST 


00486DB0 
D6D9C3C7 
D6D9C3C6 
C1c9C3C1 
C1C9C3C9 
C1c9C3C9 
C1C9C3D9 
C1C9C3E4 
C1C9C3E5 
C1D7C3D2 
C107C3E4 
E3E2C3C3 
E3E2C3C3 
E3E2C3C4 
E3E2C3C6 


D9C1C3C3 
C9CSC3E5 
E3E2C3D3 
E3E2C3D3 
E3E2C3D3 
E3E2C3F3 
E3E2C3F3 
E3E2C3F3 
E3E2C3F3 
00000000 
00000000 


00000000 
00000000 
00000000 
00000000 


00000000 
00000000 
00000000 


43001400 
00000098 
43002500 
80000000 
43170000 
00010000 
43602000 
01943800 
40C9E2ZE3 
40404040 
40E5C9E3 
D940E5E3 


3000 


00487F80 
C240F9F4 
C240F9F4 
D9ES5E3E5 
D6E5E3E5 
D940F9F4 
E7E5E3E5 
C5E5E3E5 
C340F9F3 
E440F9F4 
C5E5E3E5 
D9ES5SE3E5 
E2E5E3E5 
D9ES5SE3E5 
CO40F9F3 


CO40F9F4 
D9ESE3SE5 
C240F9F3 
C5E5E3E5 
E240F9F3 
E240F9F3 
D940F9F3 
C940F9F3 
D640F9F3 
00000000 
00000000 


00000000 
00000000 
00000000 
00000000 


00000000 
00000000 
00000000 


0195£028 
00000000 
01001750 
C3C6D9F2 
01001750 
0101BD98 
01001750 
D9C1E3C9 
E3C5E2E3 
40404040 
40C4C9E2 
C1D461C6 


00000000 
4BF2F2F7 
4BFOF7F3 
D4F3FOF1 
D4F3FOF1 
4BF1F7F1 
D4F3FOF1 
D4F3F0F1 
4BF2F3F6 
4BF2FOF6 
D4F3FOF1 
D4F3FOF1 
D4F3FOF1 
D4F3FOF1 
4BF2F3F5 


4BF2FOF6 
D4F3FOF1 
4BF2F3F5 
D4F3FOF1 
4BF3F4F8 
4BF3F2F1 
4BF2F4F5 
4BF2F3F5 
4BF2F3F5 
00000000 
00000000 


06000000 
00000000 
00000000 
00000000 


00000000 
00000000 
00000000 


010050E8 
00000000 
00484700 
01003500 
00498010 
90006000 
00484028 
00498010 
04400406 
40404040 
C1C2D3C5 
C6EZE340 


90000000 
00656C70 
006A3638 
0065C9C8 
00657860 
0066C980 
0069B180 
0065D920 
006FA450 
0065E678 
Q068EF80 
0067£178 
00669690 
0068A218 
006C4C88 


006625F8 
0066DB08 
006C0170 
00659008 
QO6BF7A8 
Q06B8EE8 
006B9520 
Q06BA050 
QO06B9E88 
90000000 
90000000 


090000000 
00000000 
00000000 
00000000 


00000000 
00000000 
00000000 


66 


66 


Wvics das ceacaces * 
*WAIT... 200s &.. ee 
*a.Q..... CFR2 * 
*REQS... 000s Oe 
¥ Ns sheen. 
*DSP..- & * 


*.m...m..RATI....* 
xxxzk ISTTESTM MO* 
*DE=N * 
xxzxx VIT DISABLE* 
*D FOR VTAM/FFST * 


*ORCGB 94.227..%. 
*ORCFB 94.073....* 
*AICARVTVM301.. 
*AICIOVTVM301...-* 
*AICIR 94.171..1. 

*AICRXVTVM301....* 
*AICUEVTVM301..R. 

*AICVC 93.236. 2u&* 
*APCKU 94.206. .W.* 
*APCUEVTVM301....* 
*TSCCRVTVM301....* 
*TSCCSVTVM301. .0.* 
*TSCDRVTVM301..S.* 
*TSCFI 93.235.%<h* 


*RACCI 94.206...8* 
*TECVRVTVM301....% 
*TSCLB 93.235.%..* 
*TSCLEVTVM301....% 
*TSCLS 93.348.,7y* 
*TSC3S 93.321.,.Y* 
*TSC3R 93.245.,n.* 
*TSC3I 93.235., .&* 
*TSC30 93.235.,.h* 


* eeeaeeveaeoveeaeanansvene * 
* @eeeeonaaooevoeseeesuen @ * 
* @eseeoeevseaceaeeoeeweeoeneaeee * 
* eseeeeaetseseseosesees * 
* eeeevueveesoeeeeee 8 * 
* eeeseoaoeeeevoeaesvee2 006 * 
* @eeeeeceaeeeaeaeeee ee @ * 
* @eeeeseeeeoeneevesea2sne * 
* * 


Figure 30 (Part 3 of 3). Sample FFST Minidump 


The Generic Alert 


VTAM FFST 


A software generic alert is built from the symptom record and routed to the NetView 
program if installed. The generic alert contains: 


The date and time that the probe was triggered 
The system name from the CVTSNAME field 

The product name (VTAM) 
The component identification and release number of the product triggering the 


probe 


The hardware identification information: 
Machine type 
Serial number 
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Model number 
Plant code 


e The dump data set and volume if a dump was taken 
e The probe statement identifier 

e The probe statement description 

e The probe statement severity level. 


The primary symptom string contains the following data supplied by VTAM. 


e PIDS/component ID: the VTAM component identifier 

e LVLS/level: the VTAM specification for the product level 
e PCSS/Probe ID: from the probe that was triggered 

e PCSS/FULL or MINI: the type of dump taken 

e RIDS: Module name from the probe that was triggered. 


See Figure 31 and Figure 32 on page 225 for a sample console listing for FFST. 
In Figure 31 the FFST program console message group 'EPW' shown informs you 
that a probe has been triggered and that data is being collected. The EPW0404I 
messages contain the primary symptom string for VTAM. 


EPWO4011 


EPWO406I 
EPW04071 
EPW04021 
EPW04041 
EPWO4041 
EPWO4041 
EPWO701I 


FFSTPROC: ERROR DETECTION INVOKED BY VTAM 287 

DUMP DATASET IS: USER1.SP41D23.VTAM. DMPQ0002 

FOUND ON VOLUME: CPDLB2 

PRIMARY SYMPTOM STRING FOR VTAM FOLLOWS: 

PIDS/569511701 LVLS/201 PCSS/ISTTSC@1 PCSS/VR#HANG PCSS/MINI 
RIDS/ISTTSCRI FLDS/TH4VRSSN VALU/HOQ00 FLDS/VRBSQRCV 
VALU/HO000 FLDS/VRBDSTSA VALU/HO0Q00000 

END OF MESSAGE GROUP 


F FFSTPROC,AP=FFST 


EPW06101 
EPWO6111 
EPW06121 
EPW06131 
EPWO6141 
EPW06151 
EPWO7011 


FFSTPROC: DISPLAY FOR APPLID FFST FOLLOWS: 294 
APPLID COUNTS probe DUMP SYMRC GENAL SYMST SUPDP 
FFST  00002/00002 EN EN EN EN EN EN 
DUMPQUAL = USER1, DUMPVOL = CPDLB2 

APPLID VENDOR 

VTAM IBM CORPORATION 

END OF MESSAGE GROUP 


Figure 31. Sample VTAM FFST Console Listing 
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EPWO250I EPWPITSK: FFST INITIALIZATION FOR VTAM COMPLETE 


FFST A=D, 


Ready; 

EPW06101 
EPW0611I 
EPW0612I 
EPW0613I 
EPW06201 
EPW06221I 
EPW0613I 
EPWO614I 
EPWO615I 
EPW06131 
EPW06171 
EPWO6181 
EPWO618I 
EPWO701I 


V=IBM, AP=VTAM 


FFST: DISPLAY FOR APPLID VTAM FOLLOWS: 
APPLID COUNTS PROBE DUMP SYMRC GENAL SYMST SUPDP 
VTAM 00011/00008 EN EN EN EN EN EN 


GA EXIT 
*N/Ax 


ALRT RCV MSG LOG /STATUS 
NETVALRT FFSTLOG1/ENABLED 


DUMP DESTINATION 
SYSTEM 


VENDOR 
IBM CORPORATION 


PRODUCT NAME 
VTAM VM/ESA V4R2 


APPLID 
VTAM 


THE FOLLOWING PROBEIDS HAVE TRIPPED AT LEAST ONCE: 
ISTCSCO1 ISTDRCO1 ISTNACO1 ISTRACO2 ISTSCC23 
ISTTESTF ISTTESTM ISTTSCO8 

END OF MESSAGE GROUP 


FFST A=CL,AP=VTAM, PROBEID=ISTTESTM, V=IBM 


Ready; 
EPWO601I 


FFST A=D, 


Ready; 


FFST: CLEAR COMMAND COMPLETE 
V=IBM, AP=VTAM 


FFST: DISPLAY FOR APPLID VTAM FOLLOWS: 


APPLID COUNTS PROBE DUMP SYMRC GENAL SYMST SUPDP 
VTAM Q0011/00007 EN EN EN EN EN EN 
DUMP DESTINATION GA EXIT ALRT RCV MSG LOG /STATUS 
SYSTEM *N/Ax NETVALRT FFSTLOG1/ENABLED 
APPLID PRODUCT NAME VENDOR 

VTAM VTAM VM/ESA V4R2 IBM CORPORATION 


THE FOLLOWING PROBEIDS HAVE TRIPPED AT LEAST ONCE: 


ISTCSCO1 
ISTTESTF 
EPWO7011 
EPWO4011 


ISTDRCQ1 ISTNACOQ1 ISTRACQ2 ISTSCC23 
ISTTSCO8 

END OF MESSAGE GROUP 

FFST: EVENT DETECTION INVOKED BY VTAM 


EPWO402I PRIMARY SYMPTOM STRING FOR PROBEID ISTTESTM FOLLOWS: 
EPWO404I PIDS/565401001 LVLS/420 PCSS/ISTTESTM PCSS/MINI 
EPWO403I EVENT DETECTION FAILED - GENERIC ALERT FAILURE 
EPWO412I NetView SUBSYSTEM IS NOT ACTIVE 

EPWO701I END OF MESSAGE GROUP 

FFST A=D, V=IBM, AP=VTAM, PROBEID=ISTTESTM 

Ready; 

EPWO610I FFST: DISPLAY FOR PROBEID ISTTESTM FOLLOWS: 

EPWO611I PROBEID COUNTS PROBE DUMP SYMRC GENAL SYMST SUPDP 
EPWOQ612I ISTTESTM 00001/00001 EN EN EN EN EN EN 
EPWO701I END OF MESSAGE GROUP 

FFST A=D,V=IBM,AP=VTAM 


Ready; 

EPWO610I FFST: DISPLAY FOR APPLID VTAM FOLLOWS: 

EPWO611I APPLID COUNTS PROBE DUMP SYMRC GENAL SYMST SUPDP 
EPWO612I VTAM 00012/00008 EN EN EN EN EN EN 
EPW06131 

EPWO620I DUMP DESTINATION GA EXIT  ALRT RCV MSG LOG /STATUS 
EPWO622I SYSTEM *N/Ax NETVALRT FFSTLOG1/ENABLED 
EPW0613I 

EPWOQ614I APPLID PRODUCT NAME VENDOR 

EPWQ615I VTAM VTAM VM/ESA V4R2 IBM CORPORATION 
EPW06131 

EPWO617I THE FOLLOWING PROBEIDS HAVE TRIPPED AT LEAST ONCE: 
EPWQ618I ISTCSCO1 ISTDRCO1 ISTNACOQ1 ISTRACO2 ISTSCC23 

EPWO618I ISTTESTF ISTTESTM ISTTSCO8 

EPWO701I END OF MESSAGE GROUP 


Figure 32. Sample VTAM FFST Console Listing 
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Using the Trap Module 


The IBM-supplied trap module (ISTRACZT) contains pretested probes that you can 
use to capture data in places where a probe has not been installed inside of VTAM. 


Follow these steps to install the trap program: 


Step Action — 

| Add an instruction to check the ATCFFST field in the ISTATCVT control 
block. lf ATCFFST is zero, VTAM FEST is not available. 

2 Add an instruction to check the ATCRACZT field in the ISTATCVT control 
block. If ATCRACZT is zero, the trap module is not available. 

3 Add an instruction to call the trap module. 
BALR R14,R15 -------- O5EF 
DC X'@Q001' -------- 0001 (default) 


A two-byte field containing X'0001' or X'0002' follows the BALR instruction. 
A value of X'0001' issues the ISTRACO1 probe macro in VTAM with the 
SDUMP option. An index value of X'0002' issues the ISTRACO1 probe 
macroinstruction with the VTAM FFST minidump option. The ISTACVT and 
the VIT are included in the minidump output along with the VTAM module list 
which contains the five significant letters of a module name, its service level, 
and its address. Control is returned to VTAM at the address following the 
two-byte index. 


Notes for Using the Trap Module: 
1. The calling module must save GP register 7. 
2. The module is reentrant. 
3. AMODE is 24 or 31. 

_ 4. All registers except 7 are saved and restored. 
5. The module is in LPALIB. 


Note: If you are trying to invoke the trap module outside of the VTAM environ- 
ment, you will need to: 


¢ Follow the Notes for Using the Trap Module on page 226. 
e Be in VTAM's key (6). 
e Be authorized. - 


APPC Sense Code or RPL6 Slip Trap (VM) 


The IBM-supplied slip traps are placed in the VTAM APPC component. These 
traps contain pretested probes that provide a full dump when a predetermined 
sense code or RPL6 (primary or secondary) return code is set. The sense code 
will trigger probe ISTRACZ3, and the RPL6RC will trigger probe ISTRACZ4. Only 
One slip trap can be active at a time. 


Follow these steps to activate a slip trap: — 


Step — Action 
q. 3 Insure that the FFST program is operational. 
2 Insure that the APPC VIT option is active. 
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Step Action 

3 Obtain the offset of the ATCASLIP field in the ATCVT. (This field is a full 
word.) 

4 Using the CP TRACE STORE commmand, set ATCASLIP to the desired 


sense code or RPL6 return code. 


Reporting a Problem 
Some of the probes that are triggered are not VTAM problems. Analyze the probe 
output to determine if a VTAM problem exists before you contact an IBM Support 
Center representative. For more information on FFST probes, see Appendix C, 
“First Failure Support Technology (FFST) Probes (MVS)(VM)” on page 845. 


Some probes might be triggered by VTAM problems that have already been fixed. 
To determine whether a problem has already been solved, take the following steps: 


1. Search the RETAIN’ database for occurrences of the symptom string you 
receive when the probe is triggered. (Also search the Information System (I/S) 
database or the database used by your organization.) 


2. If you find an APAR that applies, apply the fix. 
3. If you do not find an APAR and you cannot fix the problem, report it. 


For non-VTAM problems, call your IBM branch office. For suspected VTAM 
problems, do either of the following steps: 


e Access IBMLink and search for a similar problem by using the symptom 
string. If no matches are found, report the problem to IBM by using the 
electronic technical report (ETR) option on IBMLink. 


e Contact the IBM Support Center at 1-800-237-5511. 


If you call the IBM Support Center, the Center must verify that the documentation 
collected is adequate to fix the problem and that the problem is a VTAM problem. 


If itis a VTAM problem, the IBM Support Center opens an APAR against VTAM 
and includes the symptom string generated by the probe as part of the APAR text. 


If it is a hardware, network definition, or user definition error, the IBM Support 
Center representative creates an ASKQ item for VTAM. The ASKQ item includes 
the symptom string and the solution for the problem and can be found in the 
problem determination database (PDDB). 


Network Control Program (NCP) Dump 


You can get either dynamic or static dumps of NCP storage in a communication 
controller. 


You can use the DISPLAY NCPSTOR command (described on page 196) to 
dynamically dump up to 256 bytes of NCP storage. When you request a dynamic 
dump, VTAM sends repeated DISPSTOR Rus to the NCP until the entire contents 
of NCP storage have been transmitted. The NCP continues to operate during this 
period. As a result, the dump represents NCP storage over a period of time. 
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You can get a static dump with the VTAM dump facility (for a channel-attached or 
link-attached communication controller). You can also get a static dump with the 
independent dump utility (for a channel-attached communication controller only). 
Table 14 on page 229 summarizes the methods and requirements for dumping the 
NCP. 


NCP dumps are not allowed on lines or data links (including multipoint subarea 
links) for which IPL=NO was specified in the NCP definition deck. Therefore: 


e Code IPL=YES for any line or link which might be used to IPL or dump any 
attached type 4 physical unit. 


e If IPL=YES was not specified for a line with one or more type 4 physical units 
attached, do not try to load or dump over that line. 


Note: If you do not specify a value for IPL, the default is IPL=NO. 


lf you have a 3720 or 3745 Communication Controller with a hard disk in your 
network, you can transfer NCP, MOSS, and CSP dumps from the communication 
controller disk to the host. You can also transfer the NCP load module from the 
host to the disk. If you need to restart the NCP, you can load the NCP load 
module from the disk. 


Specifically, the following tasks are allowed with the 3720 or 3745 Communication 
Controller with hard disk: 


You can save the NCP load module to the disk. 

~You can load the NCP load module from the disk. 

You can transfer an NCP, MOSS, or CSP dump stored on the disk to the host. 
You can purge an NCP, MOSS, or CSP dump stored on the disk. — 

You can control automatic loading and dumping of the NCP to or from the disk. 
You can display up to 256 bytes of NCP dump or state vector stored on the 
disk. 


When to Use the NCP Dump 


A dump of the NCP should be taken whenever the NCP abnormally terminates or 
when an error is suspected in the NCP. It may be possible to determine that a 
problem exists in the NCP by using the VTAM |/O trace to determine what PIUs are 
being sent to and received from the communication controller and by using the 
NCP line trace to determine what is happening on the lines between the communi- 
cation controller and the link-attached logical unit. 


Using the NCP option on MODIFY DUMP 


To dump the NCP, use the MODIFY DUMP command with TYPE=NCP specified. 
For more information on this command, see “MODIFY DUMP Command” in VTAM 
Operation. You must execute a separate job to print the dump. 


Note: A data host cannot load or dump an NCP. 


You can use the DUMPDS operand of the MODIFY DUMP command to specify the 
file into which you want the dump transferred. If you omit this operand, VTAM uses 
the file specified on the PCCU definition statement for the NCP. 
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NCP Dump 


Note: If you use the same file on the MODIFY DUMP command as was named on 
the PCCU definition statement for the NCP, an earlier NCP dump may be over- 


written. 


If you omit the DUMPSTA operand, VTAM uses the link station specified on the 
VARY ACT command or the PCCU definition statement for the NCP, in that order. 


If you are using SNA network interconnection, and you want a gateway 
NCP to perform a dump, you can set its link station name on the DUMPSTA 
operand only if that NCP is in the same network as the host processor requesting 


the dump. 


If you set AUTODUMP=YES on the PCCU definition statement, a dump is taken 
automatically if the NCP abnormally terminates. This dump is written to the dump 
file named on the DUMPDS option of the PCCU definition statement. If 
AUTOIPL=YES is specified on the PCCU definition, the NCP is automatically 
reloaded after the dump is taken. With the 3720 or 3745 Communication Controller 
with hard disk, you can specify DUMPLOAD=YES on the VARY ACT command, 
which automatically stores the dump on the disk and loads the NCP load module 
from the disk. (For more information about dump commands, see “MODIFY DUMP 
Command” in VTAM Operation.) 


Note: For the 3705 only, the NCP is partially overwritten in the communication 
controller storage when the dump is taken. If the NCP is running with partitioned 
emulation programming (PEP), the emulation routines are included in the dump and 
are also partially overwritten. The 3705 must be reactivated after the dump is 


taken. 


Table 14 (Page 1 of 2). Dumping the NCP 


Method of Starting 
NCP Dump 


MODIFY DUMP 
command, 
OPTION=DYNA 


MODIFY DUMP 
command, 
OPTION=STATIC 


VTAM Error Recovery 
Procedures (auto- 
matic) 


Channel-or-Link 
Attached 


Both 


Both 


Both 


Requirements 


PCCU definition 
requirements: 


DUMPDS must be 
specified. | 
PCCU definition 
requirements: 
DUMPDS must be 
specified. 


PCCU definition 
requirements: 
DUMPDS must be 
specified. 
AUTODMP=YES 
must be specified. 


AUTOIPL may be 
specified. 


NCP Status 


Active throughout 
dump, no reacti- 
vation required. 


Deactivated when 
dump is completed; 
operator must reacti- 
vate the NCP. 


Activated after dump 
is completed if 
AUTOIPL=YES and 
restart is successful, 
or if AUTOIPL=NO 
and operator 
requests communi- 
cation controller IPL. 


Printing Dump 


Execute SSP dump 
formatting program 


IFLDUMP 


or IFUDUMP 


Execute SSP dump 
formatting program 


IFLDUMP 


or IFUDUMP 


Execute SSP dump 
formatting program 


IFLDUMP 


or IFUDUMP 
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Table 14 (Page 2 of 2). Dumping the NCP 


Method of Starting 
NCP Dump 


VTAM Error Recovery 
Procedures (with oper- 
ator intervention) 


NCP dump utility: 


IFLREAD 


or IFUREAD 


Controller-detected 
error (3720 or 3745 
with disk only) 


Channel-or-Link 
Attached 


Both PCCU definition 


Requirements NCP Status Printing Dump 


Channel-attached 


requirements: 


DUMPDS must be 
specified. 
AUTODMP=NO 
must be specified. 


AUTOIPL may be 
specified. 


See Table 80 on 
page 1165 to 
determine what 
book describes the 
NCP dump utility. 


VARY ACT require- 
ments: 


DUMPLOAD=YES 
must be specified. 


The dump slot for 
this central control 
unit (CCU) on the 


Activated after dump 
is completed if 
AUTOIPL=YES and 
restart is successful, 
or if AUTOIPL=NO 
and operator 
requests communi- 
cation controller IPL. 


Deallocate communi- 
cation controller from 
VTAM and allocate 
to the independent 
dump utility. 


| Activated after dump 


is completed if 
AUTOIPL=YES and 
restart is successful, 
or if AUTOIPL=NO 
and operator 
requests communi- 
cation controller IPL. 


Execute SSP dump 
formatting program 


IFLDUMP | 


or IFUDUMP 


IFLREAD 


uses IFLDUMP to print 
the dump automat- 
ically. 


IFUREAD Ba uses 
IFUDUMP to print the 
dump automatically. 


Execute SSP dump 


formatting program 


IFLDUMP 


or IFUDUMP 


Transfer to host using 
MODIFY DUMP with 
ACTION=TRANSFER, 


controller's hard 
disk must be 


empty. 


Using the Independent NCP Dump Utility (Channel-Attached Controller 


Only) 


To use the independent NCP dump utility, the communication controller must be 
inactive. See Table 80 on page 1165 to determine what book describes the 
following: 


e Job control language needed to invoke the independent NCP dump utility 
e NCP data areas, registers, and codes found in an NCP storage dump. 


Note: [{§¥ To use this utility in VSE, a communication controller must be 
assigned to a programmable logical unit for the partition in which it is to run. When 
the dump is complete, you must take away the assignment to make the device 
available to VTAM again. 


Communication Scanner Processor (CSP) Dump (3720, 3725, and 3745 


Only) 
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inform it of the error. You can use the MODIFY DUMP command to transfer this 
dump to a dump file in the host processor. After the dump has been transferred to 
the host, you must then run a separate job to print the dump. 


If you have a 3720 or 3745 Communication Controller with hard disk in your 
network, you can also purge the CSP dump from the communication controller with 
the MODIFY DUMP command. 


To transfer the contents of the CSP dump, use the MODIFY DUMP command with 
TYPE=CSP specified. You can use the DUMPDS operand of the MODIFY DUMP 
command to specify the file into which you want the dump transferred. If you omit 
this operand, the dump is put into one of two dump files: 


e The file specified by the CDUMPDS operand of the PCCU definition statement 
for the NCP 


e The file specified by the DUMPDS operand of the PCCU definition statement 
for the NCP (if CDUMPDS is not specified on the PCCU definition). 


For more information on the MODIFY DUMP command, see “MODIFY DUMP 
Command” in VTAM Operation. 


Maintenance and Operator Subsystem (MOSS) Dump (3720, 3725, and 
3745 Only) 


The maintenance and operator subsystem (MOSS) automatically dumps its con- 
tents when it detects an error. MOSS stores the dump on the communication con- 
troller disk, or on the MOSS diskette, and the NCP sends an alert message to the 
host to inform it of the error. You can use the MODIFY DUMP command to 
transfer this dump to a dump file in the host processor. After the dump has been 
transferred to the host, you must then run a separate job to print the dump. 


If you have a 3720 or 3745 Communication Controller with hard disk in your 
network, you can also purge the MOSS dump from the communication controller 
with the MODIFY DUMP command. 


To transfer the contents of the MOSS dump, use the MODIFY DUMP command 
with TYPE=MOSS specified. You can use the DUMPDS operand of the MODIFY 
DUMP command to specify the file into which you want the dump transferred. If 
you omit this operand, the dump is put into one of two dump files: 


e The file specified by the MDUMPDS operand of the PCCU definition statement 
for the NCP 


_ © The file specified by the DUMPDS operand of the PCCU definition statement 
for the NCP (if MDUMPDS is not specified on the PCCU definition). 


For more information on the MODIFY DUMP command, see “MODIFY DUMP 
Command” in VTAM Operation. 
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Printing Dumps 


Formatting and Printing Dump Output (MVS) (VM) 


The service aids described in this section are available for formatting and printing 
dump output. 


IPCS Service Aids (MVS) 


IPCS processes SVC dumps and high-speed stand-alone dumps for online viewing. 
For information on using IPCS with VTAM, see Chapter 7, “Using VTAM Dump 
Analysis Tools (MVS)” on page 237. 


To determine what book further describes IPCS commands, see Table 80 on 
page 1165. 


ABDUMP Service Aid (MVS) 


ABDUMP operates as part of the operating system's abnormal termination (abend) 
procedure. It automatically formats and prints abend dumps. (See “Abend Dump” 
on page 2714.) 


During ABDUMP processing, VTAM formats control blocks related to the abending 
task and prints them as part of the dump created by ABDUMP. 
ABDUMP formats the control blocks listed below. 


Note: This is an alphabetical list of the control blocks that might be in a dump. 
They might be in a different order in the dump. 


Control Block Description 


ACDEB VTAM data extent biock for the abending task 

APPCB LU 6.2 control block 

COPR Control operator control block associated with the abending task 

CRA Component recovery area for the abending task 

FMCB Function management control block and extensions for the 
abending task 

HSICB Half session information control block for the abending task 

LUCB Logical unit control block associated with the abending task 

MPST Memory process scheduling table for the abending task 

NSICB Logical network services information control block for the 
abending task 

NSSCB Logical network services storage control block for the abending 
task 

PST Process scheduling table for the abending task 

RAB LU 6.2 resourcé allocation block for the abending task 

RDTE Resource definition table application program entry for the 
abending task 

SAB _ LU 6.2 logical-resource manager-session allocation block for the 
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Following are formatted data areas described in VTAM Data Areas for MVS/ESA: 


ACDEB 
CRA 

FMCB 

LUCB 

MPST 

PST 

RDTE. 

The following information appears for each control block: 


e A header line with the name and hexadecimal address of the beginning of the 
control block 


e Under the header, the name of each selected field (as it appears in that control 
block's mapping DSECT) and the contents of the field (listed sequentially) 


e After the formatted printout, a hexadecimal dump of the entire control block. 


PRTDUMP Service Aid (VM) 


PRTDUMP enables you to format dump output from various VM dumps including 
GDUMP, SDUMP, and VMDUMP 


To format VTAM control blocks from GDUMP, SDUMP, and VMDUMP output, do 
the following: 


1. Load the dump with DUMPLOAD, and use the PRTDUMP command to format 
or view it. (Figure 72 on page 455 shows an example of using PRTDUMP.) 


For GDUMP, SDUMP, and VMDUMP, PRTDUMP asks whether you want 
VTAM control blocks to be formatted. 


2. Answer yes to format the dump. 
Note: Answering yes provides only the formatted portion of the dump. 
a. PRTDUMP then asks about VSCS formatting. 
b. Enter the formatting options you want for VSCS. 
c. VTAM then asks about VTAM formatting. 
d. Enter the formatting options you want for VTAM. 
3. Answer no to print the unformatted dump. 
If you request formatting, you can format the following VTAM control blocks from 


GDUMP or SDUMP output, depending on which virtual machine is dumped and on 
which options you select. 


Note: This list is in alphabetical order; the control blocks may be ordered differ- 
ently in a dump. 


Control Block Description 


ACDEB VTAM data extent block 

APPCB LU 6.2 control block 

ATCVT VTAM communication vector table 
BPCB Buffer pool control block 

BPDTY Buffer pool directory 


CONFT VTAM configuration table (chained to ATCVT) 
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COPR 
CRA 

ERTE 
FMCB 


FMCBE 
FMCBEXT 
HSICB 
ITTRC 
LUCB 
MPST 
NCB 
NSICB 
NSSCB 
PST 
PXB 
QAB 


~RAB 


RDTE 
SAB 
SIB 
SIBIX 
SIBRX 
SIBX 
SPANC 
SPTAE 
VRBLK 
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Control operator control block 

Component recovery area (active) 

Explicit route table entry 

Function management control block (chained to FMCB exten- 
sions) 

FMCB extensions (queued to LUCB) 

Function management control block extension 
Half session information control block 

Internal trace table 

Logical unit control block (chained to ACDEB) 
Memory process scheduling table 

Node control blocks (pointed to by RDTE) 

Logical network services information control block 
Logical network services storage control block 
Process scheduling table 

Pool expansion blocks (chained to BPCB) 

Queue anchor block for the RDT 

LU 6.2 resource allocation block 

Resource definition table entry 

LU 6.2 logical-resource-manager session-allocation block 
Session information block 

Session information block initiation extension 
Session information block resource extension 
Session information block cross-network extension 
Storage pool anchor biock 

SPANC task-associated element 

Virtual route block 


WRE with EIDs Waiting request element with event IDs. 


Following are formatted data areas described in VTAM Data Areas for VM/ESA: 


APPCB 


COPR 


HSICB 
NSICB 
NSSCB 


RAB 
SAB. 


See “GDUMP Dump’ on page 215 for more information on this dump. 


The following information appears for each control block: 


e A header line with the name and hexadecimal address of the beginning of the 


control block 


e Under the header, the name of each selected field (as it appears in that control 
block's mapping DSECT) and the contents of the field (listed sequentially) 


e After the formatted printout, a hexadecimal dump of the entire control block. 
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SADMP Service Aid (MVS) 


SADMP formats and prints low-speed stand-alone dumps. During SADMP proc- 
essing, VTAM formats selected control blocks and prints them as part of the dump 
created by SADMP. 


See the diagnostic manuals for your operating system for more information on 
SADMP. See “Stand-Alone Dump” on page 214 for more information on this 
dump. 


SDUMP Service Aid (VM) 


This service aid formats VTAM control blocks in SDUMP output. The procedure is 
the same as that given in “PRTDUMP Service Aid (VM)” on page 233. 


With SDUMP, the same VTAM control blocks as those listed in “ABDUMP Service 
Aid (MVS)” on page 232 may be formatted, depending on which virtual machine 
was dumped. 


See “SDUMP Dump” on page 215 for more information on this dump. 
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Chapter 7. Using VTAM Dump Analysis Tools (MVS) 


This chapter covers the following: | 
e “How to Read the Syntax Diagrams” on page 238 
e “Enhanced VTAM Dump Analysis Tools” on page 240 
e “Using VTAM Interactive Problem Control System (IPCS) CLISTs” on page 241 
e “Sample VTAM Dump Analysis Functions” on page 242 
e “VTAM Formatted Dump Procedures” on page 245. 
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How to Read the Syntax Diagrams 
This section describes how to read the syntax diagrams used in this book. 


e Read the diagrams from left-to-right, top-to-bottom, following the main path line. 
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Each diagram begins on the left with double arrowheads (>>) and ends on the 
right with two arrowheads facing each other (><). 


p>—| Syntax Diagram -}——_____________________»« 


If a diagram is longer than one line, the first line ends with a single arrowhead 
(>) and the second line begins with a single arrowhead. 


p>—! First Line, -_--——____________.____________» 
»—{ Second Line #---———______________——_____—_ +» 


Required operands and values appear on the main path line. 
p>>—REQUIRED_OPERAND-———________—____—_—_______—_—_________—_-»>« 


You must code required operands and values. 


lf there is more than one mutually exclusive required operand or value to 
choose from, they are stacked vertically in alphanumeric order. 


ee TRED_OPERAND_OR_VALU eo ee ee ee 
REQUIRED_OPERAND_OR_VALUE_2 , 


Optional operands and values appear below the main path line. 
L opERAND— 


You can choose not to code optional operands and values. 


lf there is more than one mutually exclusive optional operand or value to 
choose from, they are stacked vertically in alphanumeric order below the main 
path line. 


[-OPERAND_OR_VALU 14 
OPERAND_OR_VALUE_2 


An arrow returning to the left above an operand or value on the main path line 
means that the operand or value can be repeated. The comma means that 
each operand or value must be separated from the next by a comma. 


>>—REPEATABLE_OPERAN ) 


An arrow returning to the left above a group of operands or values means more 
than one can be selected, or a single one can be repeated. 


Fa ee er eee 
REPEATABLE_OPERAND_OR_VALUE_2 , 
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e A word in all uppercase is an operand or value you must spell exactly as 
shown. In this example, you must code OPERAND. 


Note: VTAM commands are not case sensitive. You can code them in upper- 
case or lowercase. 


cc. aa ca a | 


If an operand or value can be abbreviated, the abbreviation is discussed in the 
text associated with the syntax diagram. 


e If a diagram shows a character that is not alphanumeric (such as parentheses, 
periods, commas, and equal signs), you must code the character as part of the 
syntax. In this example, you must code OPERAND=(001,0.001). 


p>>—OPERAND=(001,0.001) ££ ___—_—_———____»« 


e If a diagram shows a blank space, you must code the blank space as part of 
the syntax. In this example, you must code OPERAND=(001 FIXED). 


>>—OPERAND=(001 FIXED) ——___—_—______________________________-—_»~ 


e Default operands and values appear above the main path line. VTAM uses the 
default if you omit the operand entirely. 


DEFAULT | 
— . 
¢ A word in all lowercase italics is a variable. Where you see a variable in the 


syntax, you must replace it with one of its allowable names or values, as 
defined in the text. 


SN SS Se Se 


e References to syntax notes appear as numbers enclosed in parentheses above 
the line. Do not code the parentheses or the number. 


m>—OPERAND- ng 


Note: 
1 An example of a syntax note. 


e Some diagrams contain syntax fragments, which serve to break up diagrams 
that are too long, too complex, or too repetitious. Syntax fragment names are 
in mixed case and are shown in the diagram and in the heading of the frag- 
ment. The fragment is placed below the main diagram. 


>» Reference to Syntax Fragment fp a 


_ Syntax Fragment: 


|—1ST_OPERAND , 2ND_OPERAND , 3RD_OPERAND-_—____$__$__________ 
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Enhanced VTAM Dump Analysis Tools 


The VTAM dump analysis tools are enhancements to the IPCS subcommand 
VERBEXIT VTAMMAP. To use VERBEXIT VTAMMAP you can: 


e Use the interactive panel interface 
e Enter VERBEXIT VTAMMAP subcommands from the IPCS command line 
e Create a batch job to issue the VERBEXIT VTAMMAP subcommands. 


VTAMMAP will process SVC dumps, high-speed stand-alone dumps, or abend 
dumps. 


“Sample VTAM Dump Analysis Functions” on page 242 shows how you can 
access the VITAM dump analysis tools. 


If you experience problems that you suspect to be related to the VTAM dump anal- 
ysis tools, see “VTAM Dump Analysis Tool Problems (MVS)” on page 46 for help. 


For information on required target data sets for the tools, see “Installing the VTAM 
Dump Analysis Enhancements and the VIT Analysis Tool” in the VTAM Network 
Implementation Guide. \f you want a customized interface to be active to select 
VTAM, see “Customizing the IPCS Interface” in the VTAM Network Implementation 
Guide for information on how to customize IPCS panel BLSPPRIM to activate 
option 7 on the IPCS Primary Option Menu, which is shown on page 242. 


Operating e You cannot invoke multiple functions simultaneously using the IPCS 


Environ- command line interface to formatted dump. Batch jobs do allow this with 
ment multiple calls to VTAMMAP, but only one command can be entered ona 
line. 


e The VTAM-supplied IPCS CLISTs must be used with VTAM V4R2. 
e National Language Support (NLS) is not provided. 

e IPCS for MVS/ESA is required for VTAM formatted dump. 

e ISPF V3R2 or greater is required. 


e To enable key lists for help panels APAR OY40082 and OY53592 must 
be applied to ISPF Version 3 Release 2. 


e Many of the dump analysis tools described in this chapter analyze control 
blocks that reside in VTAM private storage. If the tool cannot access 
VTAM private storage, the tool will not run correctly. 


e The CLISTs described in this chapter do not verify the accuracy of 
hexadecimal values such as storage addresses unless invoked from the 
ISPF panel. 


e If you enter hexadecimal data either on the IPCS command line or using 
the batch option, you must enclose it in two sets of single quotation 
marks. (Do not use two sets if you are using the panel interface.) 


IPCS strips off the first set of quotation marks and the second set identi- 
fies hexadecimal data. For example, to be processed correctly the string 
'02C72020' must be entered as ''02C72020''. The following example 
shows how to enter hexadecimal data in a command on the IPCS 
command line or in a batch job: 


VERBEXIT VTAMMAP 'SIBCHECK ADDR(X''01267B8'')' 
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Using VTAM Interactive Problem Control System (IPCS) CLISTs 


For the VTAM dump analysis functions that are not part of the enhanced dump 
analysis tools, you can use IPCS CLISTs to issue commands to analyze dumps of 
VTAM storage. To start the CLIST, type the CLIST name on the IPCS command 
line. 


For example, to start ISTVABND type 
ISTVABND 


on the command line. 


You can also use the CLIST command interface provided by IPCS to group TSO 
and IPCS commands together if you want to automate dump analysis procedures. 
See Table 80 on page 1165 for a list of books that describe how to use IPCS. 


Although these CLISTs are normally used online with IPCS, you can also issue 
them from the panel interface or run them in the background as batch jobs. 


The IPCS CLISTs included in VTAM and described in this chapter are: 


“ISTVABND” on page 280 
“ISTVDUMP” on page 283 
“ISTVMAP” on page 286 
“ISTVSAVE?’” on page 288 
“ISTVSLIP” on page 291. 


e e« e@® e @ 


Obtaining Online Help for CLISTs 


Note: This help operand applies only to the CLISTs; online help is invoked differ- 
ently in the panel interface. 


Each CLIST has online help information. To display it, enter the CLIST name fol- 
lowed by the HELP operand. Use no other operands, required or optional. For 
example, the following entry would display information on the ISTVDUMP CLIST. 


ISTVDUMP HELP 
After HELP information is displayed, you are prompted to either run the CLIST or 


exit the program. If you run the CLIST, you are prompted for each required 
operand. 


Debugging CLIST Errors 
Note: This DEBUG option does not apply to the panel interface. 


When you suspect an error in the execution of a CLIST, use the DEBUG option to 
list each command within the CLIST before and after execution. Specify the 
DEBUG option after any required parameters when the CLIST is invoked, as shown 
in the following example. 


ISTVSLIP DEBUG 
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Printing CLIST Output 


The output from each CLIST is put into IPCSPRNT, the IPCS PRINT file. See 
Table 80 on page 1165 to determine the book that contains information on 
IPCSPRNT. 


Sample VTAM Dump Analysis Functions 


The following sample procedures provide examples of the ways in which you may 
access the VTAM dump analysis tools. 


Using the Panel Interface 
Follow these steps to access VTAM formatted dump using the panel interface: 


Step Action 
1 Log on to TSO 
2 Access IPCS 


3 Select option 7 from the option list. 


DEFAULTS Specify default dump and options 
BROWSE Browse dump data set 

ANALYSIS Analyze dump contents 

SUBMIT Submit problem analysis job to batch 
COMMAND Enter IPCS subcommand or CLIST 
UTILITY Perform utility functions 

DUMPS Manage dump inventory 

VTAM VTAM dump analysis 

TUTORIAL Learn how to use the IPCS dialog 

EXIT Terminate using log and list defaults 


) 
1 
2 
3 
4 
5 
6 
7 
T 
X 


Enter END command to terminate IPCS dialog 


If you want a customized interface to be active to select VTAM, see “Customizing 
the IPCS Interface” in the VTAM Network Implementation Guide for information 
on how to customize IPCS panel BLSPPRIM. 
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Step = Action 
4 Select an option from the VTAMMAP Analysis Menu 


ISTD0001 VTAMMAP Analysis Menu 
Select one of the following. Then press Enter. 
APPC . . 


APPN. . 
General. 


ie - APPLCONV, PARTNRLU, APPLMODE, APPMODAL 
- APPNBASE, FNDADJCP, FNDANDCB, FNDCOS, FNDDECB, etc 
- HOST, VTAM, VTBASIC, VTFNDMOD, VTMODS, VITAL, etc 
Queues . - PABSCAN, VTCVTPAB, VTREADYQ 
Resource - RDTCHECK, RDTFULL, RDTHIER, RDTSUM, VTNODE 
Session. - FINDDSIB, FINDSIB, SES, SIBCHECK 
Search . = SRTFIND 
Storage. - SPANC, STORAGE, VTBUF, VTRPH 
Waits. . - VTWRE 
. ERs/VRs. - 
. CLISTs. .- 


ROUTES, VTVRBLK 
ISTVABND, ISTVDUMP, ISTVMAP, ISTVSAVE, ISTVSLIP 


Ne 
2. 
ce 
4. 
5. 
6. 
7. 
8. 
9. 
1 

1 


(C) Copyright IBM Corporation 1993. All rights reserved. 
Command ===> 
F1l=Help F2=Split F3=Exit F9=Swap F12=Cancel 


Follow the screen prompts to process your dump. 


Using the IPCS Command Line 


Follow these steps to access VTAM formatted dump using the IPCS command line 


interface. 
Step Action 
1 Log on to TSO 
2 Access IPCS 
3 Select option 4 from the option list. 
@ DEFAULTS - Specify default dump and options 
1 BROWSE - Browse dump data set 
2 ANALYSIS - Analyze dump contents 
3 SUBMIT - Submit problem analysis job to batch 
4 COMMAND’ - Enter IPCS subcommand or CLIST 
5 UTILITY = - Perform utility functions 
6 DUMPS - Manage dump inventory 
7 VTAM - VTAM dump analysis 
T TUTORIAL - Learn how to use the IPCS dialog 
X EXIT - Terminate using log and list defaults 
Enter END command to terminate IPCS dialog 
4 Enter a VTAMMAP command on the IPCS command line. For example: 


VERBEXIT VTAMMAP 'SIBCHECK ADDR(X''01267B8'') ' 
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Using the Batch Option 


Follow these steps to access VTAM formatted dump using the batch processing 


interface. 
Step Action 
1 Prepare the JCL data set. 
See Table 80 on page 1165 to determine what book describes IPCS. 
Examples: Sample command (single command): 


VERBEXIT VTAMMAP 'RDTFULL' 
Sample command (multiple commands): 


VERBEXIT VTAMMAP 'RDTFULL' 
VERBEXIT VTAMMAP 'SIBCHECK ADDR(X''01267B8'')' 
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VTAM Formatted Dump Procedures 


This section contains an alphabetical list of the VTAM formatted dump analysis 
tools and IPCS CLISTs available with VTAM. 


The descriptions for each tool include: 


e Procedure name 
e Description 

e Operands 

e Syntax 

e Sample output. 
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Use ALL to invoke the following functions: 


VTBASIC 
RDTFULL 
VTAM 
STORAGE 
ROUTES 
SES. 


Note: The ALL function is not displayed on the main formatted dump panel with 
other General functions, but is available on the General panel. 


Operands 

Trace output 
Enter Format to format the VIT and No format to display the VIT in 
hexadecimal format. Format is the default. 


Use the following syntax as an alternative to the panel interface. 
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Sample Output for ALL 
ALL 
ALL Analysis 


VTAM INTERNAL TRACE TABLE 02825000 

PRESENT WRAP A5OF9OFODO34AA600 LAST WRAP ASOF9AOC7OFE24F15 

CURRENT ENTRY 0284BCCO LAST ENTRY Q28ECFE 
C4E2D740 12582410 02915E88 O0CC4908 02A275F8 O2A275F8 E3EZE6E4 02929010 
D3D2E2C8 12000100 O0CC4C70 00000000  82A95442 OO0OOOOO 00000000 02929010 
E4D5D3D2 12000100 O0CC4C70 00000100  82A9546C Q0000000 01000000 02929010 
D8E4C558 12482810 02915E88 00CC4248 82A954F8 02A275F8 CODSE3D4 02929010 


ATCVT: 00CC41F8 
ATCRDT... 02955740 ATCSRT... 02C35008 ATCCONFT. O0CC18E8 
ATCBPDA.. 02953000 ATCACTRM. 0000 ATCVTLOD. 02A27650 
GWSSCP = YES 

DATA: Q0CC41F8 


+0000 
+0010 
+0020 
+0030 
+0040 


E5C5F4F2 
00000000 
02915E88 
00CC4524 
11280000 


RDTE: O2CEOCEC 
RPRNAME.. APPCAPO9 RPRENTRY. 55 
RPRDEVCH. CO6D0000 00800000 

DATA: O2CE@CEC 


40404040 
QQOOFFF9 
90000000 
00000000 
00000000 


FFF900C8 
11280000 
00000000 
13201000 
02915E88 


02825000 
00000000 
00000000 
00000010 
00000000 


RPRBITAN. 09000810 01 


+0000 C1D7D7C3 C1D7FOF9 80000000 00550200 | APPCAPQ9........ | 
+0010 00000000 00010095 O00AQ000 O2CEQDES | .......n.....".¥ | 
+0020 @2CEOD54 @000015C 9000015c ean00000 | ."..... Rca @ aden || 
+0030 2CEQ008 eA000000 eR000000 02000200 | ."....... icraPutdats | 
+0040 0090008 10010010 9000000 Oa000000 | ................ | 


No SIBs on the ATCSIBQ chain 
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Use APPLCONV to display all conversations for an APPC application. APPLCONV 
formats and displays the APPCB control block, and the COPR control block if 
present. It will also format and display the APPC resource allocation block (RAB) 
and each session control block (SAB) associated with the RAB. 


Operands 
APPC Application Name 


The APPC application name should be 1-8 alphanumeric characters. If it con- 
tains fewer than 8 characters, it is padded on the right with blanks. 


The APPC application name is required. 


Use the following syntax as an alternative to the panel interface. 


Sample Output for APPLCONV 


APPLCONV APPLNAME (APPCAP®@5) 


APPLCONV Analysis 


APPCB: 0290E6B8 
APPLUCB.. 0291A100 APPTSKID. 02818588 APPACB... @0CB4820 
APPLUN... APPCAPO5 
APPSPTAE 02906530 0290D898 02906620 029065D0 02906580 


+0000 
+0010 
+0020 
+0030 
+0040 


DATA: @290E6B8 


62C1D7D7 
00000000 
31094000 
0101001B 
00000000 


0291A100 
00000000 
00000010 
00000000 
00000000 


02818588 
024100B0 
00000000 
00CB4820 
00000000 


00000000 | .APP.j ..aeh.... | 
99000000 | ......... eee 
90000000 | .. ...cssceeeess | 
O290B088 | ......cse sees [h | 
90000000 | .......ecceeeees | 


No session limit negotiations were in progress 


Current conversation(s) for APPCAPQ5 — 


RAB: 02804028 
RABCONID. 01000003 RABCRPLA. 00000000 RABPSFSM. 01000000 04800000 
RABSABPT. 028030CO RABNETID. NETA 
RABMODEN. BATCH 
Conversation State SEND 

DATA: 02804028 


+0000 
+0010 
+0020 
+0030 
+0040 


62D9C1C2 
00000000 
40404040 
C8404040 
00000000 


SAB: 028030CO 


SABSHARE. CO 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
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62E2C1C2 
02804028 
C1D7FOF6 
00000000 
00000000 
08000360 
00000000 
00000000 
00000000 


00000000 
01000003 
C1D7D7C3 
A50F95D0 
00000000 


02818588 
01000004 
C1D7FOF6 
028030C0 
024100B4 


SABLRMFL. 00 
SABSENSE. 00000000 SABNSFG1. 03 
DATA: 028030CO 


00000000 
D5C5E3C1 
C2C1E3C3 
00000000 
QOABEEC3 
00000000 
00000000 
00000000 
00000000 


00000000 
40404040 
C8404040 
02803028 
CEQ9D9CC 
00000000 
00000000 
00000000 
00000000 


RABLUNAM. APPCAP06 


00000000 
D5C5E3C1 
C2C1E3C3 
00000000 
00000000 


SABFSM.. 


. 30 


SABNSFG2. 60 


01000004 
C1D7D7C3 
C0003000 
00000000 
00000000 


00000000 


00000000 
00000000 


| .SAB......-. seas. 
| .. .NETA — APPC | 
| APO6BATCH {... | 
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APPLMODE 


Use APPLMODE to display all logon modes in the logon mode table for conversa- 
tions between an application program and a particular partner LU. APPLMODE will 
process the LU entries searching for all LU entries that match the specified partner 
LU name and the optional partner LU network identifier. If entries are found, 
APPLMODE processes the chain of modes and determines the settings for: 


e Current session limits(x,y,z), where: 


x - Session limit 
y - Minimum number of contention winner sessions for local LU 
z - Minimum number of contention winner sessions for remote LU 


e Current session count(x,y,z), where: 


x - Active session count 
y - Active contention winners at local LU 
z - Active contention winners at remote LU 


e Pending session counts(x,y,z), where: 


x - Count of pending sessions 
y - Count of pending contention winners 
z - Count of pending contention losers 


e Pending session termination counts(x,y,z), where: 


xX - Pending termination contention winners 
+ Pending termination contention losers 
y - Pending termination contention winners 
z - Pending termination contention losers 
e Defined session limits(x,y,z), where: 


x - Defined session limit 
y - Defined minimum number of contention winner sessions for local LU 
z - Defined minimum number of contention winner sessions for remote LU 


APPLMODE formats and displays the APPCB control block, and the COPR control 
block if present. 


Operands 

APPC Application Name 
The APPC application name should be 1-8 alphanumeric characters. If it con- 
tains fewer than 8 characters, it is padded on the right with blanks. 


The APPC application name is required. 


Partner LU Name 
The partner LU name should be 1—8 alphanumeric characters. If it contains 
fewer than 8 characters, it is padded on the right with blanks. 


The partner LU name is required. 


Partner LU NetID 
The partner LU NetID should be 1-8 alphanumeric characters. If it contains 
fewer than 8 characters, it is padded on the right with blanks. 


Use the following syntax as an alternative to the panel interface. 
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p>—APPLMODE— APPLNAME(APPC_application_name)— LU(partner_LU_name)—————-———> 


E NETID(partner_LU_netid)— 


Sample Output for APPLMODE 


APPLMODE APPLNAME(APPCAP@5) LU(APPCAP06) 


APPCB: Q290E6B8 
APPLUCB.. 0291A100 APPTSKID. 02818588 APPACB... 00CB4820 
APPLUN... APPCAPO5 
APPSPTAE 02906530 0290D898 02906620 029065D0 02906580 

DATA: 0290E6B8 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
+0090 
+00A0 
+00B0 
+00C0 
+00D0 
+0Q0E0 
+00FO 
+0100 


No 


62C1D7D7 
00000000 
31094000 
0101001B 
00000000 
00000000 
C1D7D7C3 
00000000 
00000000 
00000000 
00000000 
36200000 
02906620 
00000000 
00000000 
00000000 
00000000 


APPLMODE Analysis 


0291A100 
00000000 
00000010 
00000000 
00000000 
00000000 
C1D7FOF5 
00000000 
Q292A2FC 
Q0290DA98 
00000000 
0O0000A0 
029065D0 
00000000 
00000000 
00000000 
00000000 


02818588 
024100B0 
00000000 
00CB4820 
00000000 
00000000 
00000000 
028030C0 
00000000 
00000000 
Q23FAQA8 
02906530 
02906580 
00000000 


00000000 


00000000 


99900000 
99900000 
99000000 
02908088 
99000000 
99000000 
99000000 
02804028 
99000000 
99900000 
99000000 
02900898 
99000000 
99000000 
99900000 
99000000 


session limit negotiations were in progress 


| APPCAPO5........ | 


= 
2 
ae e 


Modes between application APPCAPO5 and partner LU APPCAP06 


Mode name SNASVCMG 


Current session limits 
Current session counts 
Pending session counts 


Pending session termination counts 
Define session counts 


Mode name BATCH 


Current session limits 
Current session counts 
Pending session counts 


(X'0002',X'0001',X'0001') 
(X'0001',X'0001',X'0000') 
(X'0000',X'0000',X'0000') 


(X'00000000' ,X'0000' ,X'0000') 


(X'Q004' ,X'0002',X'0002') 


(X'0004' ,X'0002',X'0002') 
(X'0001',X'0001',X'0000') 
(X'0000',X'Q000',X'0000') 


(X'00000000' ,X'0000' ,X'O000' ) 
(X'0004' ,X'Q002',X'0002') 


Pending session termination counts 
Define session counts 
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APPMODAL 


Use APPMODAL to display all information about a particular logon mode for a con- 
versation between an application and a partner LU. APPMODAL will process the 
LU entries searching for all LU entries that match the specified partner LU name 
and the optional partner LU NetiD. If LU entries are found, the chain of modes is 
searched for a match to the specified logon mode name. If a matching logon mode 
is found, APPMODAL determines the settings for: 


e Current session limits(x,y,z), where: 


x - Session limit 
y - Minimum number of contention winner sessions for local LU 
z - Minimum number of contention winner sessions for remote LU 


e Current session count(x,y,z), where: 


x - Active session count 
y - Active contention winners at local LU 
z - Active contention winners at remote LU 


e Pending session counts(x,y,z), where: 


x - Count of pending sessions 
y - Count of pending contention winners 
z - Count of pending contention losers 


Pending session termination counts(x,y,z), where: 


x - Pending termination contention winners + losers 
y - Pending termination contention winners 
z - Pending termination contention losers 


Defined session limits(x,y,z), where: 


x - Defined session limit 
y - Defined minimum number of contention winner sessions for local LU 
z - Defined minimum number of contention winner sessions for remote LU 


APPMODAL displays: 


e Active conversations between the two applications on the logon mode by 
running the chain of RABs 


e Waiting requests off the logon mode (requests for conversations that have not 
been serviced) 


e Free sessions on the logon mode (SABs that represent sessions that are not 
currently assigned to a conversation). 


e Pending active sessions on the logon mode (SABs that represent sessions that 
are in the process of being activated on the logon mode). 


APPMODAL formats and displays the APPCB, COPR, LME (selected fields), RAB, 
and SAB control blocks. 


Operands 

APPC Application Name 
The APPC application name should be 1—8 alphanumeric characters. If it con- 
tains fewer than 8 characters, it is padded on the right with blanks. 


The APPC application name is required. 
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Partner LU Name | 
The partner LU name should be 1—8 alphanumeric characters. If it contains 


fewer than 8 characters, it is padded on the right with blanks. 


The partner LU name is required. 


Partner LU NetID 
The partner LU NetID should be 1-8 alphanumeric characters. If it contains 
fewer than 8 characters, it is padded on the right with blanks. 


Logmode Name | 
The logon mode name should be 1—8 alphanumeric characters. If it contains 


fewer than 8 characters, it is padded on the tight with blanks. 


The logon mode name is required. 


_Use the following syntax as an alternative to the panel interface. 


Syntax 


p>—APPMODAL— APPLNAME (APPC_application_name)— LU(partner_LU_name )——————————> 


a ae TT ray (aa LOGMODE ( logon_mode_name )}—_——--—----"»~« 
NETID(portner_LU_netid) | 
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Sample Output for APPMODAL 


APPMODAL APPLNAME(APPCAPO5) LU(APPCAP@6) LOGMODE (BATCH) 
APPMODAL Analysis 


APPCB: 0290E6B8 
APPLUCB.. 0291A100 APPTSKID. 02818588 APPACB... 00CB4820 
APPLUN... APPCAPO5 
APPSPTAE 92906530 02900898 02906620 029065D0 02906580 
DATA: 0290E6B8 


+0000 62C1D7D7 0©291A100 02818588 90000000 | .APP.j ..aeh.... | 
+0010 90000008 G000e0G0 02410080 eBGe0000 | ........... eek | 
+0020 31094000 00000010 oo0e0000 e0000000 | .. ............. | 
+0030 01010018 00000000 O0CB4820 O290B088 | .............. [h | 
+0040 00000000 G000000 e0ee00G0 onR0Q000 | .......... jaeaks | 


No session limit negotiations were in progress 


LME: 02968148 
LMENETID. NETA 


LMENM.... APPCAPQ@6 LMEFSM... C2 


Mode name BATCH 


(X'0004' ,X'0062' ,xX'Q002') 
Current session counts (X'09001',X'0001' ,xX'9000') 
Pending session counts (X'0000' ,X'0000' ,x'0000') 
Pending session termination counts (X'00000000' ,x'0000' ,x'0000') 
Define session counts (X'9004' ,xX'0002' ,X'Q002') 


Current session limits 


Current conversation(s) 


RAB: 02804028 
RABCONID. 010600003 RABCRPLA. 00000000 RABPSFSM. 01000000 04800000 
RABSABPT. 028030CQ RABNETID. NETA RABLUNAM. APPCAPO6 
RABMODEN. BATCH 
Conversation State SEND 

DATA: 02804028 


+9000 


62D9C1C2 


00000000 


02818588 


06000000 


+0010 0000000 01000003 01000004 DS5C5E3C1 | ............ NETA 
+0020 40404040 C1D707C3 C1D7FOF6 C2C1E3C3 | APPCAPO6BATC | 
+0030 (8404040 ASOF95D0 @28030C0 eeo00c0g | H v.n}...{.... | 
+0040 00000000 00000000 02410084 0000000 | ..... ‘ewes Hiss: 


No conversations found awaiting BID response 
No free sessions found 


No pending active sessions found 
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APPNBASE | 
Use APPNBASE to format the global APPN control blocks: 


e ACMDT 
APNVT 
DRDAT 
MTDAT 
SCDAT 
SLGDT 
TRDAT. 


The control block addresses and the hexadecimal data from each control block are 
provided, to help you diagnose APPN problems. 


Operands 


None. 


Use the following syntax as an alternative to the panel interface. 


Syntax 
b> APPNBAS E———————_———__$___——————————————— 
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Sample Output for APPNBASE 
APPNBASE 


APPNBASE Analysis 


APNVT: 00C1BD40 
+0000 C1D7D7D5 
+0010 0652A948 
+0020 00000000 
+0030 00000000 
+0040 00000000 
+0050 062EBE68 


ACMDT: 00C1C118 
+0000 C1C3D4C4 
+0010 D5C5E3C1 
+0020 F1D54040 
+0030 00000000 
+0040 OQ0A8COO 
+0050 00000064 


DRDAT: O062EB1A0 
+0000 C4D9C4E3 
+0010 069EF110 
+0020 069EF098 
+0030 8000002C 
+0040 00000000 
+0050 00000000 


MTDAT: ©62EBD70 
+0000 D4E3C4E3 
+0010 00000000 
+0020 067EDE70 
+0030 00000000 
+0040 00000000 
+0050 10300000 


SCDAT: 062D1B88 
+0000 E2C3C4E3 
+0010 06906138 
+0020 00000000 
+0030 068E9C18 
+0040 00000000 
+0050 40000000 


SLGDT: 062EB080 
+0000 E2D3C4E3 
+0010 00082400 
+0020 O6ACBAAO 
+0030 00000000 
+0040 824B5D76 
+0050 O00C1BEDO 


TRDAT: 06201848 
+0000 E3D9C4E3 
+0010 00000000 
+0020 00000000 
+0030 00000000 
+0040 10000000 
+0050 00000000 
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00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


Q004C1F0 
00000000 
40404040 
00000000 
00000000 
00000000 


0000C800 
Q69EF2ZFO 
Q69EF098 
Q69EF110 
00000000 
824B5D76 


00000000 
O68DFFA8 
067EFFDO 
00000000 
00000000 
00000000 


00000000 
069C67C8 
00000000 
00000000 
069C6480 
00000000 


00000000 
00000000 
06C10020 
00000000 
868BDC10 
Q6B6A100 


068F0008 
00000000 
00000000 
40000008 
00000000 
00000000 


062FEE88 
00000000 
00000000 
00000000 
Q068D8E08 
Q0OC1BDC4 


F1D50000 
Q9D5C5E3 
40408080 
80380100 
00000024 
00000000 


C0000018 
00041000 
Q69EFO98 
00480400 
00000000 
8686D5D0 


00000000 
068DFF48 
067EFF98 
00000000 
0000003C 
00000000 


C0000088 
00041100 
90000000 
00000000 
60C3D7E2 
000C12C1 


8000002C 
00000000 
40000004 
00000000 
824B4E9A 
Q62FEE88 


067ACF90 
40000000 
4000001C 
00000000 
40000008 
00000000 
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Q@0C1C118 
00000000 
00000000 
00000000 
00000000 
00000000 


00000004 
C14BC1F0 
00000000 
00000000 
00006060 
00000000 


Q69EF200 
C0000018 
00041000 
00000000 
00000000 
824B4E9A 


00000000 
Q67EDEF8 
Q68DE008 
00000000 
00000000 
80000004 


069C6B10 
00000000 
00000000 
00000000 
E5C3D4C7 
00000000 


Q6CCBA20 
40000024 
00000000 
00000000 
06318010 
00000060 


40000000 
00000000 
00000000 
00000000 
00000000 
00000000 


ACMD..AQIN...... 
NETA..... NETA.AQ 
i | 


sileec20seatsas.| 
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FINDDSIB | 
Use FINDDSIB to scan the ATCVT DSSIB queue for DSSIBs that meet specified 
selection criteria. The following are displayed for each DSSIB selected: 


DSSIB address 

Procedure correlation identifier (PCID) of the request 
Owning SSCP name 

Real name of the destination logical unit 

Real network ID of the destination logical unit 

Alias name of the destination logical unit — 

Alias network ID of the destination logical unit 
Adjacent SSCP in the originating direction. 


FINDDSIB has no required selection operands. If you enter no value for all 
selection operands, all DSSIBs are eligible for selection. 


To select specific DSSIBs, you may enter a value for any of the selection operands 
below. All entered values must be present in the correct position within a DSSIB 
for it to be selected. For example, if you specify both a real name and an alias 
name, only DSSIBs with the specified real name in the RNAME position and the 
specified alias name in the ALIAS position are eligible for selection. 


If you enter no value for a selection operand, DSSIBs with any value in that posi- 
tion are eligible for selection. 


Use the Process positional operand to set the number of eligible DSSIBs which will 
actually be selected and displayed (all of them or just the first one encountered). 


Operands 

PCID | | 
Specify 2-16 hexadecimal digits in the form X'x...' for the PCID associated 
with the DSRLST request. Specify an even number of digits, otherwise the 
high-order 4 bits are assumed to be zero. If the PCID entered is fewer than 16 
digits, then it is right-justified, and a match occurs with all DSSIBs with PCIDs 
whose rightmost digits match the specified digits. The specified PCID is not 
padded with any characters. 


Owning SSCP 
The owning SSCP name should be 1-8 alphanumeric characters. If it contains 
fewer than 8 characters, the leftmost characters are compared. 


Real Name 
The real name should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, the leftmost characters are compared. 


Real Network ID : 
The real network ID should be 1-8 siphanumeatie characters. If it contains 
fewer than 8 characters, the leftmost characters are compared. 


Alias Name 
The alias name of the DLU resource should be 1-8 alphanumeric characters. 
If it contains fewer than 8 characters, the leftmost characters are compared. 
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Alias Network ID 
The alias network ID of the DLU resource should be 1—8 alphanumeric charac- 
ters. If it contains fewer than 8 characters, the leftmost characters are com- 
pared. 


Adjacent SSCP 
The adjacent SSCP in the originating direction should be 1—8 alphanumeric 
characters. If it contains fewer than 8 characters, the leftmost characters are 
compared. 


Process 
Use First to display the first DSSIB that meets the selection criteria. Other- 
wise, all DSSIBs that meet the selection criteria are displayed. 


Routing in Progress 
Use Check RTIP to display only DSSIBs that indicate “routing in progress” 
(“routing in progress” is indicated when bit DSSRTIP is on). Otherwise, 
FINDDSIB does not check for “routing in progress” (that is, the DSSRTIP bit is 
ignored). 


Use the following syntax as an alternative to the panel interface. 


PCID(pcid) OSSCP (owning_sscp) RNAME (real_name ) 


E NRNID(real_netid)— a ALIAS (alias_name)— L ALNID(alias_netid)— 


ALL NORTIP 
L ASSCP(adjacent_sscp)— E — : eal 


Sample Output for FINDDSIB 


FINDDSIB 

FINDDSIB Analysis 
DSSIB PCID OSSCP RNAME NRNID ALIAS ALNID ASSCP 
Q5A13498 FO871BDOA7E3DF8C XYZSCPO5 TSO105 XYZNET 1TS0105 XYZNET ABCNET 
DSSIBs processed: 1 
DSSIBs matching search criteria: 1 
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FINDSIB 


Use FINDSIB to scan a queue of SIBs for those that meet specified selection cri- 
teria. The following are displayed for each SIB selected: 


SIB address 

Initiation finite state machine (SIBFSMIN) 
Termination finite state machine (SIBFSMTM) 
PLU NetID name 

PLU name 

SLU NetID name | 

SLU name 

PLU network address 

SLU network address 

Procedure correlation identifier (PCID). 


FINDSIB has no required operands. If you enter no values for all selection oper- 
ands, all SIBs on the ATCVT SIB queue are eligible for selection. 


To scan an SIB queue other than the ATCVT SIB queue (such as the primary or 
secondary SIB queue off of an RDTE), you must specify a primary or secondary 
SIB queue. Specify only one queue. If both a primary queue and a secondary 
queue are specified, only the secondary queue will be used. 


To select specific SIBs, enter a value for any of the selection operands below. All 
values entered must be present in the correct position within the SIB for it to be 
selected. If you select both PLU Name and PCID, only SIBs with the specified PLU 
Name in the PLUNAME position and the specified PCID in the PCID position are 
eligible for selection. 


Note: You might need to find SIBs for a resource but do not know whether the 
resource is the PLU or SLU. In this special case, you can specify the resource 
name for both the PLU name and the SLU name, and if the resource name is 
found in either one, a match occurs. The SES function can also be used to find all 
sessions for a given resource name. 


If you enter no value for a selection operand, SIBs with any value in that position 
are eligible for selection from the specified SIB queue. 


Use the Process operand to set the number of eligible SIBs that will actually be 
selected and displayed (all of them or just the first one encountered). 


Operands 

PLU Name 
The PLU name should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, the leftmost characters are compared. 


PLU NetID 
The PLU network ID should be 1-8 alphanumeric characters. If it contains 
fewer than 8 characters, the leftmost characters are compared. 


SLU Name 
The SLU name should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, the leftmost characters are compared. 
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SLU NetID 
The SLU network ID should be 1-8 alphanumeric characters. If it contains 
fewer than 8 characters the leftmost characters are compared. 


PCID 
Specify 2-16 hexadecimal digits in the form X'x...' for the PCID. Specify an 
even number of digits, otherwise the high-order 4 bits are assumed to be Zero. 
lf the PCID entered is fewer than 16 digits, then it is right-justified, and a match 
occurs with all SIBs with PCIDs whose rightmost digits match the specified 
digits. The specified PCID is not padded with any characters. 


PLU Network Address 
Specify 1-12 hexadecimal digits in the form X'x...' for the network address of 
the PLU. If you specify fewer than 12 digits, FINDSIB selects a network 
address whose rightmost digits match the specified digits. 


Example: Subarea 12 Input = 1204BC Dump Data = 0000001204BC 
Element O4BC 


SLU Network Address | 
Specify 1-12 hexadecimal digits in the form X'x...' for the network address of 
the SLU. If you specify fewer than 12 digits, FINDSIB selects a network 
address whose rightmost digits match the specified digits. 


Example: Subarea A Input = A1l23. Dump Data = 0000000A0123 
Element 0123 | 


Note: The following three operands, Displacement 1, Value 1, and Value 1 Type, 
must be specified together. They allow any field in an SIB to be checked for a 
user-specified value. 


Displacement 1 
Enter the displacement into the SIB where Value 1 is to be found. The 
maximum decimal displacement is 4095, and the maximum hexadecimal dis- 
placement is X'FFF'. 


Value 1 
Only SIBs containing this character, hex, or binary value at the displacement 
specified in Displacement 1 are selected. 


Value may contain character or hexadecimal data of 1-8 bytes in length. 
Hexadecimal data should contain an even number of up to 16 hexadecimal 
digits in the form X'xx...', otherwise the high order 4 bits are assumed to be 
zero. 


Binary data can be used to look at a particular bit within a byte. You may 
specify one byte of binary data in the form X'xx'. Only 1 bit within the byte 
may be selected. Therefore, you can specify only the following hexadecimal 
values: 01, 02, 04, 08, 10, 20, 40, and 80. A value with more than 1 bit set 
(for example, 82) will not be accepted. If you want to test 2 bits within the 
same byte, you must use Displacement 2, Value 2, and Value 2 Type, as well 
as Displacement 1, Value 1, and Value 1 Type. 


Value 1 Type . 
Enter B for binary, C for character, or X for hexadecimal to indicate the type of 
data entered for Value 1. 
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Note: The following three operands, Displacement 2, Value 2, and Value 2 Type, 
are used together. 7 


Displacement 2 
Same as Displacement 1. 


Value 2 


Same as Value 1. 


Value 2 Type | 
Same as Value 1 Type. 


Note: If both (Displacement 1,Value 1,Value 1 Type) and (Displacement 2,Value 
} 2,Value 2 Type) are specified, both sets of conditions must be met for a SIB 
to be selected. 


a, 


You may specify only one queue, Primary SIB or Secondary SIB. 


Primary SIB 
Enter the address of a SIB on the primary SIB queue off of an RDTE. The 
address must be 1-8 hexadecimal digits in the form X'x...'. If the address 
specified is fewer than eight digits, it is padded on the left with zeros. 
Secondary SIB 
Enter the address of a SIB on the secondary SIB queue off of an RDTE. The 
address must be 1-8 hexadecimal digits in the form X'x...'. If the address 


specified is fewer than eight digits, it is padded on the left with zeros. 


Note: If All is specified for Primary SIB or Secondary SIB, all elements from 
the first match are considered regardless of the address. 


Process 
Use First to display the first SIB that meets the selection criteria. Otherwise, 
all SIBs that meet the selection criteria are displayed. 


Note: Scanning the entire SIB queue can take a long time. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


p>>—FINDSIB 
PLUNAME (plu_name ) PLUNETID(plu_netid) 


a SLUNAME (s7u_name)— Ee SLUNETID(slu_netid)— hs PCID (peid)— 

is PCUNA (blu network oddress)= L SLUNA(s1u_network_address)— 

L DISP1(displacement) VAL1(data_value) TYPE1 (data_type)—| 

L DISP2(displacement) VAL2(data_value) TYPE2(data_type)— | 


ALL 
: PRIQ (primary_sib_queue)— b ae 
| SECQ(secondary_sib_queue) | 
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Sample Output for FINDSIB 
FINDSIB PLUNETID(NETB) PLUNAME(ECHOB1B) SLUNETID(NETC) SLUNAME(C01D0067) 
FINDSIB Analysis 
SIB ADDR FSMS PLUNETID PLUNAME SLUNETID SLUNAME PLUNA SLUNA | PCID 


-069AB830 3C00 NETB ECHOBIB NETC CO1D0067 DQ0DQ0000000 OHOOQOOGO00O ECC39EEE2ZA54E5D9 


SIBs processed: 1095 
SIBs matching search criteria: 1 
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FNDADJCP scans all of the partner nodes that have CP-CP sessions with this host 
for the given resource. If a resource is not provided, all partner nodes are dis- 


played. 


FNDADJCP has no required operands. If you do not enter a resource name, all 
ACPCE control blocks are formatted. 


Operands 


Network ID 


The network ID should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, the leftmost characters are compared. 


Resource Name 
The resource name should be 1—8 alphanumeric characters. If it contains 
fewer than 8 characters, the leftmost characters are compared. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


p>>—FNDADJCP 


NETID(netid) 


RESNAME (resource_name) 


Sample Output for FNDADJCP 


FNDADJCP 


ACPCB: O69EF200 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 


40C1C3D7 
F8F8F3C1 
00000000 
00000000 
00000000 
00000000 
00000000 


ACPCB: Q69EF4D0 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
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40C1C3D7 
F8F8F7C1 
00000000 
00000000 
00000000 
00000000 
00000000 


D5C5E3E9 
00040008 
00000000 
00000000 
00000000 
00000000 
00000000 


D5C5E3C1 
00040008 
00000000 
00000000 
00000000 
00000000 
00000000 


40404040 
00000000 
00000000 
00000000 
00000000 
4000000C 
10000000 


40404040 
Q69EF200 
00000000 
00000000 
00000000 
4000000C 
10000000 


FNDADJCP Analysis 


C1FOF4D7 
Q69EF4D0 
00000000 
00000000 
4000000C 
00000000 


C1FOF4D7 
Q69EF458 
00000000 
00000000 
4000000C 
00000000 


| ACPNETZ  AO4P | 
| 883A.......... 4} | 
basco wate Mewes | 
poerere rrr. | 
Eder aerate, dus | 
Se ee | 
f -diotaeeaees | 
| ACPNETA AO4P | 
| 887A...... 2...4. | 
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FNDANDCB 


Use FNDANDCEB to help diagnose problems with CP-CP sessions between this 


FNDANDCB 


host and adjacent nodes. For a particular resource, FNDANDCB finds and formats 
the adjacent node control blocks. 


Operands 


Resource Name 


The resource name should be 1—8 alphanumeric characters. If it contains 


fewer than 8 characters, the leftmost characters are compared. 


The resource name is required. 


Network ID 


The network ID should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, the leftmost characters are compared. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


p>—F NDANDCB— RESNAME (resource_name)— 7; 
NETID(netid) 


Sample Output for FNDANDCB 


FNDANDCB RESNAME (A04P887A) 


ANDCB: 969C6B10 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
+0090 
+O00A0 
+00B0 
+00CO 
+00D0 
+00E0 
+00F0 
+0100 


C1D5C3C2 
C1404040 
C3D4C740 
069C6A24 
04000000 
00000000 
00000000 
00000000 
33E74905 
00000000 
06B72EEO 
00000000 
00000001 
01000000 
00000000 
00000000 
00000000 


— CPCAP: 0679ABE8 


+0000 


C3D7C3C1 
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D5C5E3C1 
40000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
02000000 
00000000 
89400000 
00000000 
10F01002 
00000000 
80000000 
00000000 
00000000 


0900C12C1 


4BC1FOF4 
Q000000D 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
02000000 
00000000 
02000000 
00000000 
00000000 
0679ABE8 
00000000 


00000000 
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D7 F8F8F7 
C3D7E2E5 
58588000 
00C1BE88 
00000000 
00000000 
00000000 
A6C1C094 
069C69F8 
00000000 
00000000 
80000000 
Q6B6DD00 
00000000 
A0801010 
00000000 
00 


80800000 


ANCBNETA.A04P887 | 
A 


| 

(Ai. easoes CPSV 
LACMG: cs iomeieey aac 

|. Sal eeeeehs A”h | 
ere eee | 
erry ere ere | 
| saWivieewne s Seas | 
rcauubersieats cone wA{m | 
fy eX cesieenetw nae 8 | 
eer ere | 
I; ede Caw nnawen | 
le vauietedia teak sities | 
foe Oiigcisanes | 
Boe ee | 
| ceimnaiest weeds dc atelaG | 
\ seecadeess Voce | 
if Seueseeionadts | 
GPCR os Aracce cise | 
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Use FNDCOS to format mode tables, mode table entries, and class-of-service 
entries. 


FNDCOS formats and displays the following control blocks: 


e ISTCSTRU 
e ISTMCOSS 
e ISTMDTAB 
e ISTNDWED 
e ISTTGWGT. 


In order to reduce repetitious output, the control blocks ISTCSTRU, ISTNDWED, 
and ISTTGWGT will not display for consecutive, identical class of service names. 


FNDCOS has no required operands. 


Operands 
Mode Table 
The name of the mode table should be 1-8 alphanumeric characters. 


Mode Name 
The name of the entry in the mode table should be 1-8 alphanumeric charac- 
ters, 


Class of Service Name | 
The name of the entry in the APPN class of service table should be 1-8 alpha- 
numeric characters. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


>>—FNDCOS 
MODETABL (tablename) MODENAME (modename ) 


L COSNAME (cosname )] 
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Sample Output for FNDCOS 
FNDCOS 


COS Analysis 


MDTAB: 0695A460 
+0000 C5D4E2D4 
+0010 0695A9A0 
+0020 00000000 


MCOSS: 0695A9A0 
+0000 C4E8D5C1 
+0010 0693A720 
+0020 00000000 


CSTRU: 0693A720 
+0000 7BC3D6D5 
+0010 00000008 
+0020 40000000 
+0030 40 


TGWGT: 0693A760 
+0000 00000000 
+0010 75FFOOFF 


TGWGT: 0693A920 
+0000 0693A8E0 
+0010 OOFFOOFF 


NDWED: 0693A960 
+0000 00000000 


NDWED: 0693AB20 
+0000 O693AAE0 
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D6C4C540 
0695A4A0 
0695A0E0 


D4C9C340 
00000000 
00000000 


D5C5C3E3 
40000000 
0693A960 


0693A7A0 
OOFFOOFF 


99000000 
QOFFOOFF 


0693A9A0 


00000000 


00000015 
0695A4A0 


7BC3D6D5 
0695A960 


0693A2E0 
0693A760 
0693AB20 


00000000 
1E 


QOFFOOFF 
FQ 


Q0001F05 


4000FFAO 
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C0000014 
00000800 


D5C5C3E3 
00000000 


0693AB60 
0693A920 
06A4E080 


01C0004C 


01COOOFF 


| EMSMODE ....{... | 


| #CONNECT.1s\.1.- | 
lS sata utes 1x-.1z. | 
[> wee IZ Vee. u\s | 
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Use FNDDECEB to format a directory entry and its parent directory entries. 


FNDDECB formats and displays the ISTDECB control block. 


Operands 

Network ID 
The network ID should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, the leftmost characters are compared. 


Note: If you do not specify a network ID, the host network ID will be used to 
form a fully qualified network name. 


Resource Name 
The resource name should be 1—8 alphanumeric characters. If it contains 
fewer than 8 characters, the leftmost characters are compared. 


The resource name is required. 
Use the following syntax as an alternative to the panel interface. 


Syntax 


ei ae RMT RESNAME (resource_name )———————-—-"»>« 
NETID(netid) 


Sample Output for FNDDECB 
FNDDECB RESNAME (A44N) 


DECB Analysis 


DECB: 0689158 


+0000 C4C5C3C2 44000004 O6BCB7D8 0689498 | DECB....... Q..mq | 
+0010 00010000 C1F4F4D5 40404040 DS5C5E3C1 | ....A44N  NETA | 
+0020 40404040 000400F4 07041548 06707968 | er eee ae 
+0030 O6A4CFCO A682A447 G68E90FO 40000048 | .u.{wbu....0... | 
+0040 O6A38BE8 06A63978 Q6A38B80 O6A62D88 | .t.Y.w...t...w.h | 
+0050 06A63978 Q@6DFCF90 60550000 | dWeatsesowieeaes | 

Parent DECB chain 

DECB: 068E90FO 
+0000 C4C5C3C2 44000004 O6A64E58 O6A63B80 | DECB..... Wt. .W.. | 
+0010 00000000 C1FOF2D5 40404040 -D5C5E3C1 | ....AQ2N  NETA | 
+0020 40404040 000400F6 00000000 O6CEE788 | sOedsceekh | 
+0030 06A49890 A682A461 00000000 40000048 | .uq.wbu/.... ... | 
+0040 O6A38B80 O6EE8B80 00000000 0000000 | .t.............. | 
+0050 O6C908A8 O6C9OABO 00000000 | .I.y.1 | 
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FNDENDEL 


Use FNDENDEL to help diagnose problems with adjacent end nodes. For a partic- 
ular resource, FNDENDEL provides the associated ENDEL control block. 


FNDENDEL has no required operands. If you do not enter a resource name, all 
ENDEL control blocks are formatted. 


Operands 

Network ID | 
The network ID should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, the leftmost characters are compared. 


Resource Name 
The resource name should be 1—8 alphanumeric characters. If it contains 
fewer than 8 characters, the leftmost characters are compared. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


p>>—FNDENDEL 
NETID(netid) RESNAME (resource_name) 


Sample Output for FNDENDEL 
FNDENDEL RESNAME (A@4P208A) 
FNDENDEL Analysis 
ENDEL: @6A41020 


+0000 C5D5C4D3 00000000 06A41048 ®@0ODD5C5 | ENDL..... u....NE | 
+0010 E3C14BC1 FOF4D7F2 FOF8C140 40404000 | TA.A04P208A _ 
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FNDLCB 
Use FNDLCB to help diagnose problems with directory search requests. For a par- 
ticular procedure correlation identifier (PCID), FNDLCB finds and formats the fol- 
lowing control blocks: 


« LCB 

e LCB extension 

e OSCB 

e Original and best reply PLOCBs from the queue of LCB control blocks. 


FNDLCB has no required operands. If you do not enter a PCID, all control blocks 
from the previous list are formatted. 


Operands 

PCID | 
Specify 1-16 hexadecimal digits in the form X'x...' for the PCID. Specify an 
even number of digits, otherwise the high-order 4 bits are assumed to be zero. 
If the PCID entered is fewer than 16 digits, then it is right-justified, and a match 
occurs with all LCBs with PCIDs whose rightmost digits match the specified 
digits. The specified PCID is not padded with any characters. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


>>—FNDLCB 
PCID(pcid) 
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Sample Output for FNDLCB 


FNDLCB 


LCB: O6BE4E90 
+0000 40D3C3C2 
+0010 00000000 
+0020 D3A3D286 
+0030 FOF4D7F2 
+0040 00000002 
+0050 21110000 


Best reply 
PLOCB: Q6CE3B00 
+0000 40D7D3D6 
+0010 00000000 
+0020 00000000 
+0030 00000000 
+0040 00000000 


Original reply 
PLOCB: O6BBC2D8 
+0000 40D7D3D6 
+0010 00000000 
+0020 00000000 
+0030 Q004C1F0 
+0040 00000000 
+0050 D58FA88F 


LCBEXT: Q6C6E178 
+0000 D3C3C2C5 
+0010 00000000 
+0020 0004D5C5 
+0030 FI1D/F4F8 
+0040 00000000 
+0050 00000000 


LCB: 06BE4170 
+0000 40D3C3C2 
+0010 00000000 
+0020 CFA9SCD86 
+0030 FOF4D7F1 
+0040 00000002 
+0050 20110000 
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FNDLCB Analysis 


00000000 
00000000 
D58FA88F 
FOF8C100 
11100000 
00000002 


00000000 
00000000 
00808000 
00000000 
A4000040 


00000000 
00000000 
40C4A000 
F1D50000 
AQ000080 
QOODD5C5 


10000000 
0008C1F3 
E3C10000 
F9C10000 
0004C1FO 
00C00000 


O6BE4E90 
00000000 
D295A38D 
F6F5C100 
01100000 
00000002 


06BE4170 
00000000 
QO0DD5C5 
00000000 
00000000 
11000000 


00000000 
00000000 
00000000 
00000000 
00000000 


00000000 
00000000 
00000886 
00000004 
00002110 
E3C34BC3 


0004D5C5 
FICOF4F8 
00000000 
0004D5C5 
F2D50000 
068F8A38 


Q6BE4560 
00000000 
QOODD5C5 
00000000 
00000000 
01000000 


00000000 
00000000 
E3C34BC3 
00000000 
00000000 
00000000 


00000000 
00000000 
00000000 
00000000 
D3A3D286 


00000000 
00000000 
00000000 
D5C5E3C1 
D3A3D286 
FOF4D7F2 


E3C10000 
F9FZ0000 
Q008C1F3 
E3C10000 
00000000 
00000000 


00000000 
00000000 
E3C34BC3 
00000000 
00000000 
00000000 


| LtKfN.y...NETC.C | 
| @4P208A......... | 


Li SPO eis sores aeetara crane | 
Naha el ante ule eet | 
i wiedeeeteeneees | 
i eiesmeaeetece tes 

U.nieestea lesen Ssgeats Ltkf | 
E sPLOse sae eseeuns | 
| Monee oteesor | 
fs Sycatdies <Digccuvitreieans | 
| ..AQIN...... NETA | 


|; daeeetesess Ltkf | 
| N.y...NETC.CO4P2 | 


| 
| ..NETA........ A3 | 
| 
| 
| 


| O4P165A......... 


FNDLCB 
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FNDNDREC scans the topology and route selection database for node records 
matching the given resource and formats the NDREC control block. 


Use FNDNDREC to help diagnose topology and routing problems. 


Operands 

Resource Name 
The resource name should be 1—8 alphanumeric characters. If it contains 
fewer than 8 characters, the leftmost characters are compared. 


The resource name is required. 


Network ID 


The network ID should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, the leftmost characters are compared. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


p>>—FNDNDREC— RESNAME (resource_name )— 
NETID(netid) 


Sample Output for FNDNDREC 


FNDNDREC RESNAME (A04P883A) NETID(NETZ) 


NDREC: 068F3A48 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
+0090 
+00A0 
+00B0 
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D5C4D9C3 
FOF4D7F8 
00000000 
00000000 
00000000 
Q0Q00FOO 
00000000 
00000000 
C1FOF4D7 
00000000 
0A800000 
00000000 


0000002B 
F8F3C140 
00000000 
00000000 
00000000 
00000001 
00000000 
00000000 
F8F8F3C1 
00000000 
QO00FF60 
00000000 


QO0DD5C5 
40404000 
40000004 
00000000 
00000000 
00000000 
00000000 
12440DD5 
00000000 


00000000 


13000000 
00000000 


FNDNDREC Analysis 


E3E94BC1 
40000004 
00000000 
00000000 
00000000 
00000000 
00000000 
C5E3E94B 
00000000 
00000C45 
00000000 
0000 


| NDRC...... NETZ.A | 
| O4P883A ix.‘ a. | 
EE ede ter ages Oaacied | 
b  caniycGeas eager 

) sdwowecuouenies 

i) Sevaseneedase | 
D ieeaead wants .NETZ. | 
| AQ4P883A........ | 
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FNDNODE 


Use FNDNODE to format one or more APPN adjacent end nodes and/or adjacent 
network nodes. 


FNDNODE formats and displays the ISTAENCB and ISTANNCEB control blocks. 


FNDNODE has no required operands. 


Operands 

Network ID 
The network ID should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, the leftmost characters are compared. 


Note: If you specify a resource name but do not specify a network ID, the 
host network ID will be used to form a fully qualified network name. 


Resource Name 
The resource name should be 1-8 alphanumeric characters. If it contains 
fewer than 8 characters, the leftmost characters are compared. 


Type 
Enter BOTH to format both end nodes and network nodes. BOTH is the 


default. Enter EN to format only end nodes. Enter NN to format only network 
nodes. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


BOTH 
p>>—FNDNODE : 
NETID(netid) RESNAME (resource_name) EN 
NN 
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Sample Output for FNDNODE 
FNDNODE 
FNDNODE Analysis 


End Node List 


AENCB: 06824708 
+9000 C5D5C3C2 
+0010 00000000 
+0020 FOF1D7FO 
+0030 0100006E 
+0040 00000000 
+0050 06B094D0 


AENCB: Q6A4A088 
+0000 C5D5C3C2 
+0010 O6A4A6A0 
+0020 FOF3D/F8 
+0030 00000000 
+0040 00000000 
+9050 068F34D0 


ANNCB: Q6A4A020 
+9000 D5D5C3C2 
+0010 00000000 
+0020 F8F1D540 
+0030 03000006 
+0040 00000000 
+0050 068F30E8 


ANNCB: Q6A4A2F8 
+0000 D5D5C3C2 
+0010 06A4A020 
+0020 FOFZ2D540 
+0030 01000012 
+0040 00000000 
+0050 068F3278 
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00000000 
00000000 
FOF9C140 
40000000 
00000000 
00000000 


Q6A4A0FO 
00010000 
F8F2C140 
40000000 
00000000 
00000000 


00000000 
00000000 
40404040 
40000000 
00000000 
00000000 


Q6A4A020 
FFFFO000 
40404040 
40000000 
00000000 
00000000 


Q6B246A0 
QOODD5C5 
40404000 
00000000 
00000000 
00000000 


00000000 
O00DD5C5 
40404000 
00000000 
00000000 
00000000 


Q6A4A2F8 
Q9009D5C5 
40404040 
00000000 
00000027 
00000000 


00000000 
Q009D5C5 
40404040 
00000000 
00000095 
00000000 


00000000 
E3C24BC2 
01000074 
00000000 
00000000 
00000000 


Q6A4A5D0 
E3E84BC1 
00000000 
00000000 
00000000 
00000000 


Network Node List 


00000000 
E3C14BC1 
05000005 
00000000 
Q0Q000A0 
00000000 


00000000 
E3C14BC1 
01000011 
00000000 
Q0Q0009C 
00000000 
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FNDREREC 


FNDREREC 


Use FNDREREC to format one or more routing node entries including siblings and 


children. 


FNDREREC formats and displays the ISTREREC control block. 


FNDREREC has no required operands. 


Operands 
Network ID 
The network ID should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, the leftmost characters are compared. 


Note: If you specify a resource name but do not specify a network ID, the 
host network ID will be used to form a fully qualified network name. 


Resource 


Name 


The resource name should be 1—8 alphanumeric characters. If it contains 


fewer than 8 characters, the leftmost characters are compared. 


Class of Service Name 
The name of the entry in the APPN class of service table should be 1-8 alpha- 
numeric characters. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


>>—FNDREREC 


NETID(netid) 


RESNAME (resource_name) 


L COSNAME (cosnane\= | 


Sample Output for FNDREREC 


FNDREREC 


Parent: NETA.A81N COSNAME: #CONNECT 


REREC: Q6A4F5F8 


+0000 
+0010 
+0020 
+0030 
+0040 


E3D9C5C3 
00000000 
00000000 
00000000 
00000000 


Sibling chain 


NAME: NETA. 


A500N 


REREC: Q6A4F440 


+0000 
+0010 
+0020 
+0030 
+0040 


No children 


E3D9C5C3 
00000000 
000000D7 
00000000 
00000000 
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00000000 
Q6A4F440 
00010000 
00000000 
00000000 


O6A4F5F8 
00000000 
00020000 
00000000 
00000000 


Q68F30E8 
00000000 
Q6A4F440 
00000000 
00000000 


068F3020 
06A3C480 
00000000 
00000000 
00000000 
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REREC Analysis 


Q6A4D0B0 
00000000 
00000000 
00000000 
00000000 


06A4D050 
00D20005 
00000000 
00000000 
00000000 


| TREC.u58..... u}& | 
| | 
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Use FNDSCCEB to format all ISTLCBs for a specific search concentration control 


block. 


FNDSCCB formats and displays the ISTLCB control block. 


Operands 


Network ID 


The network ID should be 1—8 alphanumeric characters. If it contains fewer 
than 8 characters, the leftmost characters are compared. 


Note: If you do not specify a network ID, the host network ID will be used to 
form a fully qualified network name. 


Resource Name 
The resource name should be 1—8 alphanumeric characters. If it contains 
fewer than 8 characters, the leftmost characters are compared. 


The resource name is required. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


ee ee ap RESNAME (resource_name )——---—---- 
NETID(netid) 


Sample Output for FNDSCCB 


FNDSCCB RESNAME (BO1N) 


LCB: 075E2D40 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
+0090 
+00A0 
+00B0 
+00CO 
+00D0 
+00E0 
+00FO 
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40D3C3C2 
075E22C0 
E7F3A765 
FOF1D500 
00020001 
00020002 
00000000 
00000000 
F1D50000 
80000000 
00000000 


0005C1F5 


00000000 
13280000 
00000000 
00000000 


075BB6B0 
00000000 
0E1691B0 
00000000 
20000000 
00020000 
00020000 
00000000 
00000004 
D6E2C3C2 
00000000 
FOFOD500 
00000000 
00000000 
00000000 
00000000 


075E22C0 
07510640 
Q009D5C5 
00000000 
00000000 
20000000 
00020001 
01000067 
D5C5E3C2 
00000000 
Q75E2D40 
00000004 
00000000 
07 1BAB00 
00000000 
00000000 


FNDSCCB Analysis 


07258020 
07521000 
E3C24BC2 
00000000 
00000000 
00000000 
20000000 
Q004C2F0 
00000000 
00000000 
10000000 
D5C5E3C1 
00000000 
00000000 
00000000 
00000000 


| ar ere 
|, sei Gacseeh: vea'des.<| 
| X3x...j...NETB.B | 
OIN swsaceuwnwees | 
Per eee | 
ee ee | 
ce ee | 
unde teceaa BO | 
ANG Sita NETB | 
| sae QOSCBesduncas | 
| ..A5OON..... NETA | 
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FNDSITCB 


Use FNDSITCB to help diagnose problems with the session services for LU-LU 
sessions. For a particular procedure correlation identifier (PCID), PLU name or 
network identifier, or SLU name or network identifier, FNDSITCB provides the asso- 
ciated SITCB control block. 


FNDSITCB has no required operands. If you enter no values for all selection oper- 
ands, all SITCB control blocks on the queue are eligible for selection. 


Operands 

PLU Name 
The PLU name should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, the leftmost characters are compared. 


PLU Network ID 
The name representing the network ID of another network outside the host 
network where a resource resides should be 1—8 alphanumeric characters. If it 
contains fewer than 8 characters, the leftmost characters are compared. 


SLU Name 
The SLU name should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, the leftmost characters are compared. 


SLU Network ID 
The name representing the network ID of another network outside the host 
network where a resource resides, should be 1—8 alphanumeric characters. If 
it contains fewer than 8 characters the leftmost characters are compared. 


PCID 
Specify 1-16 hexadecimal digits in the form X'x...' for the PCID. Specify an 
even number of digits, otherwise the high-order 4 bits are assumed to be zero. 
If the PCID entered is fewer than 16 digits, then it is right-justified, and a match 
occurs with all SITCBs with PCIDs whose rightmost digits match the specified 
digits. The specified PCID is not padded with any characters. 


Note: You might need to find SITCBs for a resource but do not know whether the 
resource is the PLU or SLU. In this case, you can specify the resource name for 
both the PLU name and the SLU name, and if the resource name is found in either 
one, a match occurs. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


>>—FNDSITCB 
PLUNAME (plu_name) PLUNETID(plu_netid) 


LE SLUNAME (5 2u_name)— Ls SLUNETID(slu_netid)— L PCID(pcid)— 
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FNDSITCB 


Sample Output for FNDSITCB 
FNDSITCB 


FNDSITCB Analysis 


SITCB: O6ACBAAO 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 


E2C9C3C2 
00000000 
00000000 
FCE2D9D8 
00000000 
00000000 


 SITCB: @6ACBO20 
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+0000 
+0010 
+0020 
+0030 
+0040 
+0050 


E2C9C3C2 
00000000 
00000000 
FCE2D9D8 
00000000 
00000000 


00000000 
00000000 
00000000 
FCE2D9D8 
00000000 
00000000 


00000000 
00000000 
Q6ACBAAO 
FCE2D9D8 
00000000 
00000000 


Q00D7D5E2 
86881220 
Q6ACB020 
00000000 
00000000 
00000000 


00D7D5E2 
86881220 
06C24AA0 
00000000 
00000000 
00000000 


04000000 
00000000 
FCD9C3C6 
FCE2D9D8 
00000000 
00000000 


04000000 
00000000 
FCD9C3C6 
FCE2D9D8 
00000000 
00000000 
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FNDTGREC 


Use FNDTGREC to help diagnose topology and routing problems. For an origin 
control point (CP), FNDTGREC formats the NDREC and TGREC control blocks 
linked between it and the destination control block. 


The name of the destination CP is in the TGREC control block. The name of the 
origin CP is in the NDREC control block and is a required operand for FNDTGREC. 
The CP name is in the form of a network identifier and a resource name. 


Operands 

Origin Resource Name 
The origin resource name should be 1-8 alphanumeric characters. If it con- 
tains fewer than 8 characters, the leftmost characters are compared. 


The origin resource name is required. 


Origin Network ID 
The origin network ID should be 1-8 alphanumeric characters. If it contains 
fewer than 8 characters, the leftmost characters are compared. 


Destination Network ID 
The destination network ID should be 1-8 alphanumeric characters. If it con- 
tains fewer than 8 characters, the leftmost characters are compared. 


Destination Resource Name 
The destination resource name should be 1-8 alphanumeric characters. If it 
contains fewer than 8 characters, the leftmost characters are compared. 


Use the following syntax as an alternative to the panel interface. 


Syntax 
>>—FNDTGREC— ORESNAME (origin_resource_name)———___________._ + 
ONETID(origin_netid) 


L DNETID(destination_netid)— L DRESNAME (destination_resource_name)— 
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FNDTGREC 


Sample Output for FNDTGREC 


FNDTGREC ORESNAME(N317468) ONETID(NETA) 


NDREC: 068F37F0 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
+0090 
+00A0 
+00B0 


D5C4D9C3 
F3F1F7F4 
96A08560 
99900000 
99900000 
90000F40 
99900000 
99000000 
DSF3F1F7 
99000000 
94800000 
99900000 


TGREC: Q6A08560 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
+0090 
+00A0 
+00B0 
+00CO 
+00D0 


E3C7D9C3 
40000004 
068F37FO 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
4BC1FOF1 
00000000 
00000000 
00000000 
00000000 


TGREC: 06A08640 
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+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
+0090 
+00A0 
+00B0 
+00CO0 
+00D0 


E3C7D9C3 
40000004 
068F37FO 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
4BC1FOF2 
00000000 
00000000 
00000000 
00000000 


90000024 
FOF84040 
06A08800 
00000000 
00000000 
00000001 
00000000 
00000000 
F4FOF800 
00000000 
00468000 
00000000 


00000000 
00000000 
068F3020 
00000000 
00000000 
00000000 
00000000 
00000000 
00001446 
D5000000 
00000000 
00000000 
00000000 
00000000 


06A08560 
00000000 
068F30E8 
00000000 
00000000 
00000000 
00000000 
00000000 
00001446 
D5000000 
00000000 
00000000 
00000000 
00000000 


Q00CD5C5 
40404000 
40000004 
00000000 
00000000 
00000000 
00000000 
11440CD5 
00000000 
00000000 
23000000 
00000000 


06A08640 
00000000 
Q69E6D40 
90000000 
90000000 
16470000 
204C0000 
00000000 
12800109 
00040000 
00000000 
00000000 
00000000 


Q6A08720 
00000000 
06A07020 
00000000 
00000000 
16470000 
204C0000 
00000000 
12800109 
01360000 
00000000 
00000000 
00000000 


FNDTGREC Analysis 


E3C14BD5 
40000004 
00000000 
00000000 
00000000 
00000000 
00000000 
C5E3C14B 
00000000 
00000C45 
00000000 
0000 


0F700000 
00000024 
00000001 
00006900 
00000000 
00348076 
00000000 
00000000 
D5C5E3C1 
00000000 
00000000 
00000000 
00000000 


Q0F700000 
00000024 
00000001 
00000000 
00000000 
00260076 
00000000 
00000000 
D5C5E3C1 
00000000 
00000000 
00000000 
00000000 
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NDRC..... 


317408 
..@-..h. 


@eeoeenee @ 


NETA.N | 


e eee 
o@eeoee @ | 


eeeeo0#2ee 
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HOST 


Use HOST to determine the following for the VTAM host from which a dump was 
taken: 


Address space ID (ASID) 

CP name 

CP network address 

Host CORM name 

e Network ID 

e Node type 

e SSCP network address 

e Whether the CDRM supports CDRSCs 
e Whether the SSCP is gateway-capable. 


This information can provide a valuable point of reference for network problem 
diagnosis. 


Operands 
None. 


Use the following syntax as an alternative to the panel interface. 


Equated Symbol 
Symbol Description 


ATCVT VTAM's ATCVT. 


ISTSRTDcdrmname 
Derived from the CDRM RDTE for the host (for example, for cdrmname 
SSCP1A, the ISTSRTDcdrmname symbol would be ISTSRTDSSCP1A). 


Sample Output for HOST 


HOST 
HOST Analysis 
NetID NETA 
ASID (Hex) 001D 
ASID (Dec) 29 
Subarea (Hex) 0000000D Element 0001 
Subarea (Dec) 13 Element 1 
CDRM Name A13N 


This SSCP is gateway capable 
This CDRM supports dynamic CDRSCs 


CP Network address Q0000000D 0006 


CP Name NETA.A13N 
This is a pure network node 
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ISTVABND (IPCS CLIST) 


ISTVABND 


System completion code 
Program interrupt code 
Instruction length code 
PSW 


Failing instruction 


Translation exception address 


Registers at time of abend 
VTAM save area chain (forward and backward) 
Symptom string information. 


“Restricted Materials of IBM” 
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ISTVABND determines the following in an MVS dump of a VTAM abend: 


Abending module name, displacement, PTF level 


IPCS symbols for each register and the PSW address are created. After 
ISTVABND executes, storage pointed to by the registers and PSW can be 
accessed by using these IPCS symbols. 


The ISTVABND command can also be issued from the panel interface. 


Equated Symbols 
Symbol(s) 


RO, REGO 
R1, REG1 
R2, REG2 
R3, REG3 
R4, REG4 
R5, REGS 
R6, REG6 
R7, REG7 
R8, REGS 
R9, REGO 
R10, REG10, RA, REGA 
R11, REG11, RB, REGB 
R12, REG12, RC, REGC 
- R13, REG13, RD, REGD 
R14, REG14, RE, REGE 
R15, REG15, RF, REGF 
PSW 
MODULE NAME 


280 _ VTAM V4R2 Diagnosis 


Description 
Register 0 
Register 1 
Register 2 
Register 3 
Register 4 
Register 5 
Register 6 
Register 7 
Register 8 
Register 9 
Register 10 
Register 11 
Register 12 
Register 13 
Register 14 
Register 15 


PSW address 
Module that called ISTSSCZZ 
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Note: If the abend was the result of an ABENDOAYQ issued by module ISTSSCZZ, 
the registers at the time of the call to ISTSSCZZ (rather than the registers 
when ISTSSCZZ issued the ABENDOASY) are used to create the symbols 
listed above. Also, the module name, displacement, and PTF level of the 
module that called ISTSSCZZ are displayed. 


Additional Information 
An abend can occur in SRB mode or in TCB mode. 


For an MVS dump of an abend in TCB mode, ISTVABND locates the abending 
TCB and the RTM2WA. The completion code (system or user) in the TCB is ana- 
lyzed and displayed. From the RTM2WA, the program interrupt code (PIC), instruc- 
tion length code (ILC), and translation exception address (TEA) if valid, are 
analyzed and displayed. 


For an abend in SRB mode, there is no RTM2WA. The PIC, ILC, TEA, registers, 
and PSW are taken from the SDWA which is found in the MVS FRR stack. 


The PSW address is used to determine the abending module name, displacement, 
and PTF level. Register 13 (which usually contains a pointer to the abending mod- 
ule's save area) is used to trace the save area chain forward and backward (by 
calling ISTVSAVE) to show module linkage. 


Symptom string information is obtained from the variable recording area (VRA) of 
the SDWA. 
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Sample Output from ISTVABND 
The following is a sample of the output from ISTVABND for an ABENDOC4 in 
module ISTTRTLR. 


ISTVABND 


CLIST ISTVABND STARTED AT 09:06:51. 
(ISTVABND) THIS DUMP WAS THE RESULT OF AN ABEND IN SRB MODE 


SYSTEM COMPLETION CODE 
PROGRAM INTERRUPT CODE 


0C4 
0010 


INSTRUCTION LENGTH CODE = 0004 
PSW AT TIME OF ABEND: 076C2000 82DE96FA 

TRANSLATION EXCEPTION ADDRESS = 30580038 

THE FAILING INSTRUCTION IS: 43603001 

ISTAPCFR-VTAM FRR DUMP 


VTAMMAP input data 
VTFNDMOD SYMBOL(PSW) NNTERNAL 


Module name: ISTTRTLR 
Compile date: 92.224 

Address entered: O2DE96FA 
Module entry point: 02DE9558 
Displacement into module: 1A2 


First '40'X bytes of module: 
DATA: 02DE9558 


+0000 47FOFQ14 OFC9EZE3 E3D9E3D3 D940F9F2 | .00..ISTTRTLR 92 | 
+0010 4BF2F2F4 9QOECDOOC O5CO18FD 586QF000 ee . | 
+0020 58D06000 1F99BF97 C4OF58AQ C40A187D | . Ailes ae ‘| 
+0030 1£791E7A 50706000 5880C3CE 18871488 | . x | 
Storage around address entered: 
DATA: Q2DE96E6 
+0000 5840806C 41500002 1£544130 50304190 | . .%.&......8... | 
+0010 00021F66 43603001 16690200 30013000 | ..... vine Kesaive | 
+0020 42603000 4130504F 1F664360 30011669 | .-....&|...-.... | 
+0030 02003001 30004260 30004110 DOQ681E94 | K...... ~.eee}eem | 
REGISTERS AT TIME OF ABEND: 
REGO = 82D9FEQ@ REG1 = O28F8010  REG2 = 00000000  REG3 = 3058003A 
REG4 = BQ580008 REGS = BO58000A REG6 = 00000000  REG7 = 00C49D40 
REG8 = 00000002 REGS = 00000002 REGA = 00000008 REGB = 00000110 
REGC = 82DE9572 REGD = O2EC9EAQ EGE = 82DE974C REGF = 00000000 


SAVE AREA CHAIN (STARTING WITH SAVE AREA AT Q2EC9EAQ): 
-> SSTM -> ISTT -> CPNQ 
CURRENT SAVE AREA = ACRT 


ACRT 


SYMPTOM STRING: 
AB/S00C4 LVLS/410 RIDS/ISTAPCFR#R PIDS/5695-11701 ADRS/000001A2 
RIDS/ISTTRTLR 


LVLS/92.224 REGS/0C188 


CLIST ISTVABND ENDED AT 09:07:16. RETURN CODE = 0. 
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ISTVDUMP 


ISTVDUMP determines the SDATA options in effect when an MVS dump occurs. 
The SDATA options determine which MVS storage areas are requested to be 
dumped when the dump is taken by VTAM (SDUMP) or requested by the operator 
(console dump). ISTVDUMP can thus help you determine why a specific address 
is not in an MVS dump. 


Note: ISTVDUMP shows what areas were requested for a dump. However, 
because the area was requested does not guarantee that information is in 
the dump. If an area is missing from your dump, it can be due to other 
reasons (for example, data is lost transferring the dump from the dump data 
set to tape, or the dump data set is too small, causing a partial dump to be 

_ taken). 


The ISTVDUMP command can also be issued from the panel interface. 


Syntax 


gS SD 


Additional Information 
When you are working with an MVS dump of VTAM, the following information may 
be useful: 


e The PSA must have been dumped to access low-core address hexadecimal 
408. 


e CSA must have been dumped to access the ATCVT. 


e VTAM private storage must have been dumped (RGN parameter specified 
when the dump is taken) to access most VTAM modules and control blocks. 


lf neither CSA nor RGN is requested for a dump, ISTVDUMP issues a warning 
message. See the sample output in “Sample Output from ISTVDUMP” on 

page 285 for an example. To resolve most VTAM problems, you must have the 
VTAM private region and CSA. 


When the dump is taken, ISTVDUMP analyzes the RTM recovery termination 
control table (RTCT) and the SDUMP parameter list (SDUMP) to determine what 
was requested on the SDATA operand. 


For a stand-alone dump obtained by AMDSADMP, the pointer to the RTCT is zero. 
If you run ISTVDUMP against a stand-alone dump, a message is issued indicating 
that the RTCT pointer is zero and the CLIST stops processing. See Table 80 on 
page 1165 to determine the book that contains information on SDATA options, 
RTCT, and SDUMP. 


The following list shows all of the possible settings of the SDATA flags in the 


_ SDUMP parameter list. Note that there is no specific indication for extended areas 


(above 16MB). When an area is requested (for example, RGN), it is dumped, as is 
the extended area if present. 
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SDUMP Parameter List 


Flag Description 

_ SDUALPSA Dump all PSAs in the system. 
SDUPSA Dump the current PSA. 
SDUNUC Dump the nucleus. 
SDUSQA Dump SQA. 
SDULSQA Dump LSQA. 
SDURGN Dump region (private area). 
SDULPA Dump active LPA module for RGN. 
SDUTRT Dump trace table and GTF buffers. 
SDUCSA Dump CSA. 
SDUSWA Dump SWA for region. 
SDUSMDMP Summary dump requested. 
SDUNSMDP Do not dump summary dump. 
SDUNSPSA Do not dump all PSA. 
SDUNASQA Do not dump SQA. 
SDUALNUC Dump all nucleus areas. 
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Sample Output from ISTVDUMP 
In this sample, note that CSA and RGN (SDATA option SDURGN) were both 
requested. 


ISTVDUMP 


CLIST ISTVDUMP STARTED AT 13:36:44. 
SDATA OPTIONS REQUESTED FOR THIS DUMP: 


SDUALPSA - DUMP ALL PSA'S IN THE SYSTEM 
SDUPSA - DUMP THE CURRENT PSA 

SDUNUC - DUMP THE NUCLEUS 

SDUSQA - DUMP SQA 

SDULSQA - DUMP LSQA 

SDURGN - DUMP REGION (PRIVATE AREA) 
SDULPA - DUMP ACTIVE LPA MODULE FOR RGN 
SDUTRT - DUMP TRACE TABLE / GTF BUFFERS 
SDUCSA - DUMP CSA 

SDUSWA  - DUMP SWA FOR REGION 

SDUSMDMP - SUMMARY DUMP REQUESTED 
SDUALNUC - DUMP ALL NUCLEUS AREAS 


CLIST ISTVDUMP ENDED AT 13:36:44. RETURN CODE = Q. 
In this sample, RGN and CSA were not requested when the dump was taken. 


ISTVDUMP 
CLIST ISTVDUMP STARTED AT 15:32:17. 


SDATA OPTIONS REQUESTED FOR THIS DUMP: 


SDUALPSA - DUMP ALL PSA'S IN THE SYSTEM 
SDUNUC - DUMP THE NUCLEUS 

SDUSQA - DUMP SQA 

SDULSQA - DUMP LSQA 

SDULPA - DUMP ACTIVE LPA MODULE FOR RGN 
SDUTRT - DUMP TRACE TABLE / GTF BUFFERS 
SDUSWA DUMP SWA FOR REGION 

SDUSMDMP - SUMMARY DUMP REQUESTED 


KEEKEKRKKERKRKEKEKEKRKKKERRERKERKREKEKEE 


* PRIVATE REGION WAS NOT DUMPED ~* 


KEKKKEEKEKEKERKEKKREREREREREKKKRKKKE 
HREKKKEKEKRKEKEKKKKKKKEEKE 


* CSA WAS NOT DUMPED « 


HREKKKEKKKRKERKEKEKEKREEEE 


CLIST ISTVDUMP ENDED AT 15:32:18. RETURN CODE = 0. 
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ISTVMAP 


Use ISTVMAP to determine the starting and ending addresses and area size of the 
following major MVS/ESA storage areas in a dump: — 


Extended maximum possible region 
Extended private region 
Extended CSA 

Extended MLPA 

Extended FLPA 

Extended PLPA 

Extended SQA 

Extended read/write nucleus 
Extended read/only nucleus 
CSA 

MLPA 

FLPA 

PLPA 

SQA 

Read/only nucleus 
Read/write nucleus 
Maximum possible region 
Private region 

Low storage. 


When you cannot find an address in a dump, the starting and ending addresses of 
major MVS/ESA storage areas in the dump will help you determine if and where 
that address is in the dump. 


Also use ISTVMAP when areas of storage needed to diagnose a VTAM problem do 
not appear to be in the dump. Knowing which storage area a given address 
represents and what was actually dumped can be helpful in determining why a spe- 
cific storage address is not ina dump. See ISTVDUMP to determine which storage 
areas were requested to be dumped when the dump was taken. 


The ISTVMAP command can also be issued from the panel interface. 


Syntax 


SV SSE SS Se 


Additional Information 

The storage in an MVS/ESA system is mapped by the CVT virtual storage address 
extension, the global data area (GDA), and the local data area (LDA). ISTVMAP 
uses these areas to produce a map of storage that is unique to the dump being 
processed. The map does not apply to any other dump. 
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ISTVMAP (IPCS CLIST) 


Sample Output from ISTVMAP 
ISTVMAP 


CLIST ISTVMAP STARTED AT 21:37:40. 


06500000 
06500000 
02624000 
025FAQ00 
025F7000 
01C13000 
01311000 
012A9000 
01000000 


QOFDEQ0O 
00F3D000 
QOE6D000 
00C98000 
00C97000 
00092000 
00800000 
00005000 
00005000 
00000000 


7FFFFFFF 
OB4FFFFF 
Q64FFFFF 
02623FFF 
O25FOFFF 
O25F6FFF 
O1C12FFF 
@1310FFF 
@12A8E4F 


OOFFFFFF 
00 FDDABF 
OOFSCFFF 
QOE6CFFF 
00C97FFF 
QOC96FFF 
OOC91FFF 
007 FFFFF 
Q0414FFF 
QO0004F FF 


79B00000 
02000000 
Q3EDCO00 
Q002A000 
00003000 
Q09E4000 
00902000 
00068000 
Q02A8E50 


00022000 
QOOADACO 
Q0OD0000 
001D5000 
00001000 
00005000 
00492000 
007FB0Q00 
00410000 
00005000 


VIRTUAL STORAGE AREA 


EXTENDED 
EXTENDED 
EXTENDED 
EXTENDED 
EXTENDED 
EXTENDED 
EXTENDED 
EXTENDED 
EXTENDED 


am ow oe ow om @ oe on oe ae ae oe an oe ae om ow on oe oe 


MAXIMUM POSSIBLE REGION 
PRIVATE REGION 

CSA 

MLPA 

FLPA 

PLPA 

SQA 

READ/WRITE NUCLEUS 
READ/ONLY NUCLEUS 


READ/ONLY NUCLEUS 
READ/WRITE NUCLEUS 


SQA 
PLPA 
FLPA 
MLPA 
CSA 


MAXIMUM POSSIBLE REGION 
PRIVATE REGION 
LOW STORAGE 


CLIST ISTVMAP ENDED AT 21:37:43. RETURN CODE = 0. 
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ISTVSAVE 


ISTVSAVE follows a VTAM save area (VWA) chain forward and backward, starting 
from the specified save area address. 


Using the save area address that was entered, ISTVSAVE follows the forward save 
area chain until it encounters a zero or not valid forward chain pointer. Then, 
starting again at the original save area address that was entered when ISTVSAVE 
was invoked, ISTVSAVE follows the backward save area chain until it encounters a 
zero or not valid backward chain pointer. If an error occurs during the attempt to 
access storage, the save area chain in that direction (forward or backward) is 
assumed to end. 


The VWA eye-catchers are displayed, separated by arrows (->) indicating the order 
of VTAM module linkage. If ISTVSAVE encounters a save area with no (or a not 
valid) eye-catcher, the output for that eye-catcher may contain unprintable charac- 
ters or periods (for example, SSUW -> SSZZ -> ....). The “....” means that the first 
word of the save area does not contain a standard VTAM save area eye-catcher. 


Operands 
You can specify an address or symbol pointing to any valid VWA. You must enter. 
at least one of the following when you invoke ISTVSAVE: 


address - 
The address of a VTAM module save area should be 1-8 hexadecimal digits. 


symbol | 
A previously equated IPCS symbol that points to a VTAM save area. 


X_ If the current address being displayed points to a VTAM save area, the IPCS 
symbol X can be used to represent it. 


Optionally, you can specify: 


ALL 
To list the register save area for each save area on the chain. 


The ISTVSAVE command can also be issued from the panel interface. 


Syntax 
p>—] STVSAV ae add re Sect i a = ee aes 
symbol] ALL | 


Additional Information 

Most VTAM modules use standard register-save-area linkage. The first word of a 
register save area is optional, and some VTAM modules store a 4-character identi- 
fier there. These identifiers are the VWA eye-catchers, which are displayed by 
ISTVSAVE. In most cases, VTAM MVS module names have the form ISTxxCxx, 
and the identifier consists of the 4th, 5th, 7th, and 8th characters of the name of the 
VTAM module that owns the save area. 


Example: VTAM Module Name = ISTACCRT VWA eye-catcher 


= C'ACRT' 
VTAM Module Name = ISTSSCTM VWA eye-catcher 


C'SSTM' 
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If the save area does not follow these rules, it should follow the enhanced save 
area chaining convention. If it follows neither, the results of this CLIST are unpre- 
dictable. For the enhanced save the chain, the first 3 characters are IST followed 
by the module name. The address pointed to by register 13 will always point back 
to the save area chain. For a discussion of both methods, see “Using Save Area 
Module Linkage Conventions—Subarea” on page 552. | 


Sample Output from ISTVSAVE 
The following is a sample of the output from ISTVSAVE for an ABENDOAS in 
module ISTSSCZZ. 


ISTSSCZZ is the SSABEND macro processor. The purpose of this module is to 
issue the ABENDOASY. It is necessary to know the caller of ISTSSCZZ to diagnose 
the ABENDOAS properly. In this example, the caller of ISTSSCZZ was 
ISTSSCUW. 


The “current save area” is the save area pointed to by the address entered when 
ISTVSAVE was invoked (that is, the save area for module ISTSSCUW is at 
address 0B2B0480, which is the address where IPCS was positioned when 
ISTVSAVE was invoked using the symbol X). 


ISTVSAVE R13 ALL 


SAVE AREA CHAIN (STARTING WITH SAVE AREA AT 0B2B04860) : 
ACRT -> SSTM -> SSTP -> SSKT -> SSU3 -> SSUW -> SSZZ -> .... 


CURRENT SAVE AREA = SSUW 


The following is a sample of the output from ISTVSAVE for an ABENDOC4 in 
module ISTDECH2. This is a particularly long save area chain. 


ISTVSAVE 981DE88 


SAVE AREA CHAIN (STARTING WITH SAVE AREA AT 0981DE88) : 

ACRT -> ACRR -> DEST -> DESD -> DEIS -> DEP2 -> DESA -> DESF -> DEQR -> 
DESF -> DESJ -> DEP2 -> DEVP -> DEK2 -> DESG -> DESB -> DESC -> DEIS -> 
DEK2 -> DEVP -> DEG2 -> DEVP -> DER3 -> DEH2 -> . J. -> .00. 


CURRENT SAVE AREA = DEH2 


The following is sample output from ISTVSAVE with R13 specified as the symbol 
operand. R13 represents address 04FB53C8. 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Chapter 7. Using VTAM Dump Analysis Tools (MVS) 289 


ISTVSAVE (IPCS CLIST) 


ISTVSAVE R13 ALL 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


(ISTVSAVE) CLIST WAS INVOKED WITH ADDRESS/SYMBOL 'R13' 
(ISTVSAVE) SYMBOL 'R13' REPRESENTS ADDRESS 04FB53C8 


CURRENT SAVEAREA: 


SAVE AREA FOR SSNP 


04FB53C8. 


E2E2D5D7 04FB5360 


| SSNP...-| 


04FB53D0. O4FB5448 00000000 00000000 O0000000 |............. siete 
04FB53E0 LENGTH(48)==>All bytes contain X'00' 


04FB5410. 


84A3968E 


‘|dto. | 


SAVEAREA(S) ENCOUNTERED FOLLOWING THE FORWARD SAVEAREA CHAIN: 


SAVE AREA FOR .... 


04FB5448 LENGTH(76)== 


>All bytes contain X'00' 


SAVEAREA(S) ENCOUNTERED FOLLOWING THE BACKWARD SAVEAREA CHAIN: 


SAVE AREA FOR SSTD 
E2E2E3C4 O4FB52F0 04FB53C8 84A75C4C 
FFA395C8 00000000 O4A99CD8 04FB5224 
@4AACF30 04A521F8 00000015 04A395C8 
Q@4A521F8 04FB5348 O4AACF30 O4A99CD8 
O@4AACFO8 84A759FA 84A75AAE 


04FB5360. 
04FB5370. 
04FB5380. 
04FB5390. 
04FB53A0. 


SAVE AREA 
O4FB52F0. 
04FB5300. 
04FB5310. 
04FB5320. 
04FB5330. 


SAVE AREA 
04FB5288. 
Q4FB5290. 
O4FB52A0. 
Q4FB52B0. 
Q4FB52C0. 
04FB52D0. 


SAVE AREA 
04FB5170. 
Q4FB5180. 
04FB5190. 
Q4FB51A0. 
04FB51B0. 


SAVE AREA 
04FB5010. 
04FB5020. 
04FB5030. 
Q04FB5040. 
04FB5050. 


FOR SSTV 
E2E2E3E5 
FFA759E0 
Q4FB5224 
O5003EEE 
Q4AACF08 


FOR SSTD 


O4FB52FO 
Q4A99CD8 
00000015 
04A51598 
00000000 


FOR SSTM 
E2E2E3D4 
FFA759E0 
00000000 
O4AACF30 
O4AACF48 


FOR ACRT 
C1C3D9E3 
FFA41170 
84A0D988 
04A99228 
8498CD9E 


04FB5288 
00000000 
Q4AACF30 
04FB5360 
84A766F2 


84A75D6A 
Q4FB5224 
Q4AACF30 
Q04A99CD8 


04FB5010 
Q4AACF48 
04A51598 
Q5003EE6 
84A41192 


00000000 
04A99CD8 
04FB5010 
04A99228 
0498DD9D 


04FB5360 84A76856 
Q4A99CD8 04FB5224 
Q4FB520C 04FB5348 
Q4A51598 O4A99CD8 
84A767AE 


E2E2E3C4 04FB5170 
FFA766D8 90000000 
O4AACF30 O4FB520C 
@4FB520C 00000015 
O@4AACF48 84A759FA 


Q4FB5288 84A41A8A 
Q4A99CD8 04A51598 
Q000001D 04A51598 
Q4FB5224 O4A99CD8 
84A4127A 


Q4FB5170 8498E214 
Q4A99CD8 00035558 
00000000 84FB5008 
Q4A99228 O4A99CD8 
04A99228 


|SSTD...0...Hdx*<| 


Xe Nes 2.Q..0.| 


|. 
| 
pooner 


| SSTD....| 
ie .Odx)|.x.Q.. a 


Xe \esaaeZe OQ. Ve 


|. zk. .zk. ae atic 7.0 
|dq...q...zk. 


SAVE AREA CHAIN (STARTING WITH SAVE AREA AT 04FB53C8): 


ACRT - SSTM - SSTD - SSTV - SSTD - SSNP - .... 
CURRENT SAVE AREA = 
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ISTVSLIP 


Use ISTVSLIP to display the registers and PSW that were current at the time of an 
SLIP dump. The registers and PSW are extracted from the SDUMP buffer pointed 
to by the CVT. 


All 16 general registers and the PSW are displayed, along with the module name 
and displacement that the address portion of the PSW represents (the module in 
contro! at the time the SLIP trap occurred). The module name and displacement 
that register 14 represents (usually the calling module or within the current module) 
are also displayed. If the dump was not taken as a result of an SLIP trap, a 
message to that effect is displayed. 


IPCS symbols are created for each register and the address portion of the PSW. 
After ISTVSLIP has executed, storage locations pointed to by these registers (or 
PSW) can be displayed using these symbols in the IPCS LIST command. For 
example, L R4 will display the storage pointed to by register 4 at the time the SLIP 
trap occurred. 


Note: ISTVSLIP does not support stand-alone dumps taken after the SLIP 
ACTION=WAIT MVS system command is issued. 


The ISTVSLIP command can also be issued from the panel interface. 


Syntax 
p> ISTVSLI Pr 
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Equated Symbols 
Symbol(s) 


RO, REGO 
R1, REG1 

R2, REG2 

R3, REG3 

R4, REG4 

R5, REGS 

R6, REGG 

R7, REG7 

R8, REGS 

R9, REGO 

R10, REG10, RA, REGA 
R11, REG11, RB, REGB 
R12, REG12, RC, REGC 
R13, REG13, RD, REGD 
R14, REG14, RE, REGE 
R15, REG15, RF, REGF 
PSW 


Additional Information 


“Restricted Materials of IBM” 
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Description 
Register 0 
Register 1 
Register 2 
Register 3 
Register 4 
Register 5 
Register 6 
Register 7 
Register 8 
Register 9 
Register 10 
Register 11 
Register 12 
Register 13 
Register 14 
Register 15 
PSW address 


The dump data set name is displayed to verify that the correct dump is being proc- 
essed. The title of the dump is displayed for additional verification that the dump 
being processed is, in fact, an ISTVSLIP dump. 


To determine the module name, displacement, and PTF level for the PSW and reg- 
ister 14, VIFNDMOD is called. The PSW address and register 14 are used as 


input to VIFNDMOD. 


292 VTAM V4R2 Diagnosis 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


ISTVSLIP (IPCS CLIST) 


Sample Output from ISTVSLIP 
ISTVSLIP 


CLIST ISTVSLIP STARTED AT 17:42:19. 

DUMP DATASET NAME: IPCS.P620527.DUMPA 

TITLE FROM DUMP: SLIP DUMP ID=0001 

THE ADDRESS OF THE SDUMP BUFFER IN THE CVT IS 00C95000. 
PRIMARY ASID AT THE TIME OF ENTRY TO SLIP IS X'QOOA' 
PSW AT ENTRY TO RTM: 00000000 01D03790 


REGISTERS WHEN SLIP TRAP MATCHED: 


REGO = 08000000 REG1 = O80A9000 REG2 = 00000012 REG3 = 00000012 
REG4 = O07FF158 REGS = 8Q@C1EFC8 REG6 = 00003000 REG7 = 00000004 
REG8 = Q000000B REGS = 81E6190C REGA = 0650CE4Q0 REGB = 81E51A98 
REGC = 81D0347A REGD = 0650CE40 REGE = O01F2A714 REGF = Q10E35E0 


(ISTVSLIP) PROCESSING OF PSW FOLLOWS: 


VTAMMAP input data 
VTFNDMOD ADDR(X'01D03790') NNTERNAL 


Module name: ISTCFF3D 
Compile date: 92.318 

Address entered: 01D03790 
Module entry point: 01D03462 
Displacement into module: 32E 


First '40'X bytes of module: 
DATA: 01003462 


+0000 47FOFO16 10C9EZ2E3 C3C6C6F3 C44040F9 | .00..ISTCFF3D 9 | 
+0010 F24BF3F1 F8Q005CO 185F1861 187041FO | 2.318..{.7./...0 | 
+0020 00005800 CB7E47FO C0160000 020089FO | ..... =.0{..... io | 
+0030 Q@OO8BFFD CQ121B11 OA7818A1 18161807 | ..t.{...... .... | 
Storage around address entered: 
DATA: ©1D0377C | 
+0000 89000018 16101823 58F00010 S8FOFO34 | i........ 0...00. | 
+0010 58FOFO20 O5EF47FO C5445850 04081255 | .00....0E..&.... | 
+0020 4780C34A 91405488 4780C34A 58205B50 | ..C¢j .h..C¢..$& | 
+0030 12224780 (C34A9102 54884710 C34A5850 | ....C¢j..h..C¢.& | 


Address is in extended pageable LPA (above the 16M line). 
Extended pageable LPA starting address: 01C13000 

Extended pageable LPA ending address:  O25F8FFF 
(ISTVSLIP) PROCESSING OF REG 14 FOLLOWS: 

VTAMMAP input data 


VTFNDMOD ADDR(X'1F2A714') 


Module name: ISTDSCGD 
Compile date: 92.256 

Address entered: 01F2A714 
Module entry point: 01F2A6A0 
Displacement into module: 74 
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First '40'X bytes of module: 


DATA: @1F2A6A0 


+0000 47FOFQ14 OFCOEZE3 C4E2C3C7 C440F9F2 .00..ISTDSCGD 92 | 


| 
+0010 4BF2F5F6 QOECDOOC 18BF41FO 0005800 | .256..}....0.... | 
+0020 B95C0700 47FOBO2C 00000200 s9FO0008 | .*...0...... i. 
+0030 BFFDBO28 18110A78 18C150D@ coo450Co | ......... A&}{.&{ | 


Storage around address entered: 


DATA: 01F2A700 


+0000 B93E58AQ ACE45630 BSE858FO A0005820 | ..... U...Y.0.... | 
+0010 BSF8Q5EF 980£1028 58201020 12FF4770 | .8..q......ee00- | 
+0020 BO94D203 2000B92C 58E04000 50£02024 | .mK...... \ .&\.. | 
+0030 47FOBOQ98 41FQQ008 12FF4770 B52041A0 | .0.q.0.......... | 


Address is in extended pageable LPA (above the 16M line). 
Extended pageable LPA starting address: 01C13000 
Extended pageable LPA ending address: O025F8FFF 


(ISTVSLIP) THE REGISTER SAVE AREA CHAIN COULD NOT BE ANALYZED. 
REG 13 IS NOT VALID OR STORAGE IS NOT AVAILABLE. 


CLIST ISTVSLIP ENDED AT 17:43:30. RETURN CODE = 0. 


294 VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


oo 


“Restricted Materials of IBM” PABSCAN 
Licensed Materials — Property of IBM 


PABSCAN 


A request/response unit processing element (RUPE) represents the unit of work 
VTAM must perform for a given request or response received from the network. 
VTAM queues RUPEs to a process anchor block (PAB). Knowing what type of 
work is queued to a PAB may be important in resolving storage and performance 
problems. Use PABSCAN to scan a chain of RUPEs queued to a PAB and obtain 
a summary of the RUPEs by RU type. 


You may scan all work elements on the PAB, or limit the search to RUPEs con- 
taining a specific value in one or more of the following fields: 


e Destination address field (DAF) 

e Origin address field (OAF) 

e CPCB operation code (CPCBOPC) 

e Request/Response unit (RUPERQD,RUPERSD) 
e A user-specified location within the RUPE. 


For each work element that is selected, the RU is extracted and counted. After all 
of the selected work elements have been counted, a summary showing the number 
of work elements containing each RU type is displayed. 


Operands 
You must specify one address or one symbol to represent the first RUPE in the 
chain of RUPEs to be analyzed. 


Address ; 
Enter 1-8 hexadecimal digits in the form X'x...' for the address of the chain of 
RUPEs to be analyzed. If the address is fewer than 8 digits, it is padded on 
the left with zeros. 


~ IPCS Symbol 


Enter an IPCS symbol name that is 1-31 alphanumeric characters. The 
symbol name represents the beginning of a chain of RUPEs. Do not include a 
period. 


Under IPCS, the symbol X represents the address currently being displayed. If 
the current address is pointing to a chain of RUPEs, this symbol may be used. 


If you specify no other selection operands, the first 100 RUPEs are analyzed and a 
summary of the RUPEs by RU type is displayed. 


If you use more than one of the following operands, all of the selection criteria must 
be met for a RUPE to be selected. 


Destination Address Field 
Only RUPEs containing this destination address field (RUPEDAF) are eligible 
for selection. Specify 1-12 hexadecimal digits in the form X'x...'. If the 
address is fewer than 12 digits, the rightmost digits are compared. 


Origin Address Field 
Only RUPEs containing this origin address field (RUPEOAF) are eligible for 
selection. Specify 1-12 hexadecimal digits in the form X'x...'. If the address 
is fewer than 12 digits, the rightmost digits are compared. 
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Control Op Code 
Only RUPEs containing this CPCB op code are eligible for selection. The 
Control Op Code must be 1-8 hexadecimal digits in the form X'x...'. If the op 
code is fewer than 8 digits, it is left-justified and compared with the leftmost 
digits in the dump. 


Request/Response Unit 
Only RUPEs that contain this RU are eligible for selection. The leftmost digits 
of field RUPERSD are compared (if RUPERSP is nonzero) to the value 
entered, otherwise the leftmost digits of RUPERQD (if RUPERQP is nonzero) 
are compared to the value entered. The length used for the comparison is the 
length of the value entered. 


Detail 
The default is N. Specify Y to have the following fields extracted and displayed 
for each RUPE meeting the selection criteria: 


Position of RUPE on the PAB 

RUPE address 

CPCB op code (CPK) 

Origin address field (RUPEOAF) 

Destination address field (RUPEDAF) 

First 4 bytes of request/response unit (if present) 

User-data at a specified displacement (if Displacement and Value are spec- 
ified). 


One line of output per RUPE is produced. 


Max 
Specify the maximum number of RUPEs to be processed. The default for MAX 
is 100. If MAX is not specified, only the first 100 RUPEs on the PAB are ana- 
lyzed. The maximum value for MAX is 99999. If the maximum number of 
RUPEs are processed and more remain on the PAB, PABSCAN will report the 
number of unprocessed elements remaining on the PAB. 


Displacement 
Enter the displacement into the RUPE where Value is to be found. The 
maximum decimal displacement is 4095 and the maximum hexadecimal dis- 
placement is X'FFF'. 


Length 
Enter a value of 1~8 for the number of bytes you want displayed, starting at the 
displacement specified in Displacement. 


Length must be used with the Displacement operand. Together, they display 
any portion of a RUPE. The Length operand cannot be used with the Value 
and Value Type operands. 


Note: The following two operands, Value and Value Type, must be used 
together with the Displacement operand. They allow any field in a RUPE to be 
checked for a user-specified value. The Value and Value Type operands 
cannot be used with the Length operand. 


Value 
Only RUPEs containing this data at the displacement specified in Displacement 
are eligible for selection. | 
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Value may contain character or hexadecimal data of 1-8 bytes in length. Char- 
acter data should consist of alphanumeric characters. Hexadecimal data 
should contain an even number of up to 16 hexadecimal digits in the form 
X'xx...'; otherwise, the high order half-byte is assumed to be Zero. 


Binary data can be used to look at a particular bit within a byte. You may 
specify one byte of binary data in the form X'xx'. Only 1 bit within the byte 
may be selected. Therefore, you can specify only the following hexadecimal 
values: 01, 02, 04, 08, 10, 20, 40, and 80. A value with more than 1 bit set 
(for example, 82) will not be processed. 


Value Type 
Enter B for binary, C for character, or X for hexadecimal to indicate the type of 
data entered for Value. 


Additional Information 
To determine whether an RU is a request or a response, PABSCAN first checks 
field RUPERSP. 


If RUPERSP is nonzero, the RU is considered to be a response. The designation 
RSP, along with the contents of field RUPERSD, are used to represent the 
response. 


If RUPERSP is zero, field RUPERQP is then checked. 

If RUPERQP is nonzero, the RU is considered to be a request. The designation 
REQ, along with the first 4 bytes of the RU from field RUPERQD, are used to rep- 
resent the request (using 4 bytes allows for the largest of the RU headers and also 
picks up the format byte for RU headers which are 3 bytes long). 

If both RUPERQP and RUPERSP are zero, the designation NORU, along with the 
contents of field CPCBOPC, are used to represent the RU. The designation NORU 


notes the fact that no RU (neither request nor Reperee) pointer existed in the 
RUPE or the length of the RU was zero. 


Use the following syntax as an alternative to the panel interface. 


Syntax 
>> —PABSCAN—— set La Ce 2 a med TP aR 
SYMBOL (symbolL) DAF (destination_address) 
& OAF (origin_address)— L CPK(cpcb_op_code)— 


EP sical : el 
RU(request/response_unit) DETAIL MAX (max imum) 
a DISP (displacement )—— VAL(data_value)— TYPE (data_type)—— 
LEN(length) 
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Sample Output for PABSCAN 


PABSCAN SYMBOL (X) 


PABSCAN Analysis 


ELEM# RUPEADDR CPCBOPC RUPEOAF RUPEDAF RU USERDATA 
1 062E3028 00000000 000000010003 000000010003 **NORU*« 

00000000 REQ occurred 1 

RUPEs left on the chain 0 

Elements processed 1 
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PARTNRLU 


PARTNRLU 


Use PARTNRLU to display all partner LUs for an APPC application. PARTNRLU 
formats and displays the APPCB control block, the COPR control block if present, 
and the LME. 


Operands 
APPC Application Name 
The APPC application name should be 1-8 alphanumeric characters. If it con- 


tains fewer than 8 characters, it is padded on the right with blanks. 


The APPC application name is required. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


p>>—PARTNRLU— APPLNAME (APPC_application_name )}—_————_——— 


Sample Output for PARTNRLU 


PARTNRLU APPLNAME (APPCAP65) 


APPCB: 0290E6B8 
APPLUCB.. 0291A100 APPTSKID. 02818588 APPACB... 00CB4820 
APPLUN... APPCAPQ5 


APPSPTAE 02906530 0290D898 02906620 


DATA: O0290E6B8 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
+0090 
+00A0 
+00B0 
+00C0 
+00D0 
+00E0 
+00FO 
+0100 


62C1D7D7 
00000000 
31094000 
01010018 
00000000 
00000000 
C1D7D7C3 
00000000 
00000000 
00000000 
00000000 
36200000 
02906620 
00000000 
00000000 
00000000 
06000000 


PARTNRLU Analysis 


Q291A100 
00000000 
00000010 
00000000 
00000000 
00000000 
CiD7FOFS 
00000000 
Q292A2FC 
0290DA98 
00000000 
QOQOO0A0 
029065D0 
00000000 
00000000 
00000000 
00000000 


02818588 
024100B0 
00000000 
00CB4820 
00000000 
00000000 
00000000 
028030CO 
00000000 
00000000 
023FA0A8 
02906530 
02906580 
00000000 
00000000 
00000000 


029065D0 02906580 


00000000 
00000000 
00000000 
0290B088 
00000000 
00000000 
00000000 
02804028 
00000000 
00000000 
00000000 
0290D898 
00000000 
00000000 
00000000 
00000000 


No session limit negotiations were in progress 


LME: 0290B148 
LMENETID. NETA 
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RDTCHECK displays the RDTE name, RDTE address, RDTE entry type, RDTE 
header type, network address, and the current and desired state of an RDTE. In 
addition, RDTCHECK displays pertinent flag bits from the following control blocks if 
available: 


Resource definition table application entry (RAP) 

Resource definition table physical unit entry (RCC) 

Resource definition table cross-domain resource manager (RCDRM) 
Resource definition table cross-domain resource entry (RCDRS) 
Resource definition table allocation entry prefix (RCPRE) 

Resource definition table line entry (RLN) 

Resource definition table logical unit entry (RLU) 

Common physical unit prefix (RPU) 

Resource definition table NCP entry (RRN). 


Operands 


You must specify one address or one symbol. 


Address 
Enter 1-8 hexadecimal digits in the form X'x...' for the address of the RDTE to 
be analyzed. If the address is fewer than 8 digits, it is padded on the left with 
zeros. 


IPCS Symbol 
Enter 1-31 alphanumeric characters for an IPCS symbol name that has been 
previously equated with the address of the RDTE to be analyzed. Do not 
include a period. 


Under IPCS, the symbol X represents the address currently being displayed. If 
the current address is an RDTE, this symbol may be used to refer to it. . 


Use the following syntax as an alternative to the panel interface. 


Syntax 


pe REY BODOG 8g Se rege eee 
SYMBOL (symbol) 
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Sample Output for RDTCHECK 


RDTCHECK ADDR(X'02CE0776') 


RDTE: Q2CEOQ77C 
RPRNAME.. APPCAPO5 RPRENTRY. 55 
RPRDEVCH. CO6D0000 00800000 

DATA: 9@2CE077C 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
+0090 
+00A0 


C1D7D7C3 
40040000 
Q2CEO7E4 
02CEO008 
00010009 
00000001 
00000000 
02CE1020 
00000000 
00000000 
00000000 


C1D7FOQF5 
0001008D 
0000015C 
00000000 
10010010 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


80000000 
00060000 
0000015C 
00000000 
00000000 
C06D0000 
Q02CE11A8 
00000000 
00000000 
00700033 


RPRENTRY X'55' indicates an application 
RPRHDTYP X'02' indicates an application 
Network address 


Current state of RDTE 
Desired state of RDTE 


RPRAOPN 
RPRDOM 
RPRDINUS 
RPRGIST 
RPRDAFAD 


X'Q0000001008D' 


X'Q505' 

X'Q505' 

RPRE STATUS BIT FLAGS 
Supports LU to LU sessions 


1 

1 LU is in this domain 

1 This node has been activated at least once 
1 

1 


Initial status from system definition 


RDTCHECK Analysis 


RPRBITAN. 01000910 01 


00550200 
02CE0878 
00000000 
05050505 
00000000 
00800000 
00000000 
00000000 
00000002 
38E40000 


header 


RDT added by config services 


Non-Backup Session Count X'QQ0000002' 
Session Limit (Zero Means No Limit) X'0000' 
X'Q000' 


Backup Session Count 


LOGAPPL 
RCPRRECD 
RCPCROSS 
RCPPRIM 
RCPCYMOD 
RCPCYSET 
RCPCSM 
RCPSEC 
RCPLVL 
RCPUNRCV 
RCPSLUSS 
RCPT21NS 


1 Record ok 
1 Supports cross domain sessions 
1 LU is primary capable 
0Q Operator modifiable feature -None 
00 SYSDEF defined feature -None 
0001 Unstable 
1 LU is secondary capable 
Level of VTAM >= 4.1 for an LU in an NCP segment 


RCPRE STATUS BIT FLAGS 


Session started is sent by resource when acting as SLU 


RDTCHECK 


1 
1 Receipt of unrecognized control vector on CINIT supported 
1 
1 


T2.1 nodes and extended BIND supported 


RAPASLGI 
RAPPARS 
RAPAPASS 
RAPAACQ 
RAPAPPC 
RAPSRBX 


RAP STATUS BIT FLAGS 


Application first time logon issued 
Parsess(yes) was coded 
CLSDST pass authorized 


APPC=yes was coded 


1 
1 
1 
1 Acquire authorized 
1 
l 


Schedule exits in SRB mode (0S/VS only) 
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Use RDTFULL to display all resource definition table entries (RDTEs) and node 
control blocks (NCBs) or a selected RDTE. 


Operands 

RDTE Name 
The RDTE name should be 1—8 alphanumeric characters. If it contains fewer 
than 8 characters, it is padded on the right with blanks. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


pe>—RDTFULL 
RDTE (name) 


Note: Using this function without specifying a name may produce large amounts 
of data. 
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Sample Output for ROTFULL 
RDTFULL 


RDTFULL Analysis 
QAB: 02955740 
+0000 D9C4E340 O00D0000 O0CC1ABO 


02CE0008 | ROT .....6.[.".. | 


+0010 00100000 00700074 
RDT: QOCC1ABO 


RPRNAME.. VTAMSEG 


+0000 £5E3C1D4 £2C5C740 80000000 00020200 | VTAMSEG ........ 
+0010 00000000 00000000 00000000 OOCC1B18 | ............. b.. | 
+0020 00000000 O00000BO O0000000 G0000000 | ....... léceleaeaees | 
+0030 00000000 0000000 0000000 05050505 | .............66. 
+0040 00020001 00000000 00000000 00000000 | ..............6. 


RDTE: O0CC1B60 


RPRNAME.. SSCP1A 


+0000 E2E2C3D7 F1C14040 80000000 00110200 | SSCPIA ........ 
+0010 00000000 00010001 00020006 OOCC1C5C | ............. é.* | 
+0020 Q@OCC1BC8 00000210 QOQ000BO O0Q0Q00O | .6.H....... tert. 3 
+0030 OOCC1ABO 0000000 0000000 05050505 | .d.[............ | 
+0040 0000009 40000100 00000000 00000000 | .... .........6. 


RDTE: O2CEOCEC 
RPRNAME.. APPCAPO9 RPRENTRY. 55 
RPRDEVCH. CQ6D0000 00800000 

DATA: O2CE@CEC 


+0000 
+0010 
+0020 
+0030 
+0040 


+0130 
+0140 
+0150 


C1D7D7C3 
00000000 
Q2CEOD54 
Q@2CE0008 
00090008 


00000000 
00000000 
00000000 
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RPRDEVCH. 00000000 00000000 
DATA: OOCC1ABO 


RPRENTRY. 11 
RPRDEVCH. CO6D0000 00800000 
DATA: O0CC1B60 


C1D7FOF9 
00010095 
0000015C 
00000000 
10010010 


90000000 
00020001 
00000000 


80000000 
Q00A0000 
0000015C 
00000000 
90000000 


00000000 
00010000 
00000000 
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RPRBITAN. 09000810 01 


00550200 
O@2CEQDE8 
00000000 
02000200 
00000000 


00000000 
06130000 
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RDTHIER 


If an RDTE name is specified, the specified RDTE and all RDTEs below it in the 
RDTE hierarchy are displayed. If no RDTE name is specified, RDTHIER is iden- 
tical to RDTFULL. 


Operands 

RDTE Name | 
The RDTE name should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, it is padded on the right with blanks. 


If the specified RDTE occurs more than once in a dump, the hierarchies for 
each RDTE are displayed. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


p>—RDTHIER 


RDTE (name ) 


_ Sample Output for RDTHIER 


RDTHIER RDTE(VTAMSEG) 


RDT: O@CC1ABO 


RPRNAME.. VTAMSEG 


+0000 
+0010 
+0020 
+0030 
+0040 


E5E3C1D4 
00000000 
00000000 
00000000 
00020001 


RDTE: Q0CC1B60 


RPRNAME.. SSCP1A 


+0000 £2E2C3D7 F1C14040 80000000 00110200 | SSCPIA ........ 
+0010 00000000. 00010001 00020006 OOCC1C5C | ............. 6.* | 
+0020 OOCCIBC8 00000210 O00000B0 0000000 | .6.H....... [tied | 
+0030 OOCC1ABO 00000000 OOO00000 05050505 | .b.[............ | 
+0040 00000009 40000100 0000000 GH0000000 | .... ........05. 


RDTE: Q2CEOCEC 
RPRNAME.. APPCAPQ9 RPRENTRY. 55 
RPRDEVCH. CQ6D0000 00800000 

DATA: Q2CEOCEC 


+0000 
+0010 
+0020 
+0030 
+0040 


+0130 
+0140 
+0150 
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C1D7D7C3 
00000000 
Q@2CEOD54 
02CE0008 
00090008 


00000000 
00000000 
00000000 


RDTHIER Analysis 


RPRENTRY. Q2 
— _RPRDEVCH. 90000000 00000000 
DATA: O0CC1ABO 


E2C5C740 
00000000 
00000080 
00000000 
00000000 


80000000 
00000000 
00000000 
00000000 
00000000 


RPRENTRY. 11 
RPRDEVCH. CO6DQ000 00800000 
DATA: 00CC1B60 


C1D7FOF9 
00010095 
9000015C 
00000000 
10010010 


00000000 
00020001 
00000000 


80000000 
QE0A0000 
0000015C 
00000000 
00000000 


00000000 
00010000 
00000000 


RPRBITAN. 02000100 00 


00020200 
60CC1B18 
00000000 
05050505 
00000000 


RPRBITAN. 90000940 00 


RPRBITAN. 99000810 01 


00550200 
Q2CEODE8 
00000000 
02000200 
00000000 


00000000 
00130000 
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RDTSUM 


RDTSUM 


Use RDTSUM to display a summary for all RDTEs or for a selected RDTE. 


Operands 
RDTE Name 
The RDTE name should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, it is padded on the right with blanks. 


Syntax 


pe NO ee ee 
RDTE (name ) 


Sample Output for RDTSUM 


RDTSUM 


QAB: 02955740 
D9C4E340 Q00D0000 OOCC1ABO O2CE0008 
00100000 00700074 


+0000 
+0010 


VTAMSEG 
SSCPI1A 
ISTATAQO 
ISTNOP 
ISTPDCLU 
TSTAPNCP 
SSCPIA 
ISTPUS 
ISTGROUP 
ISTPDILU 
TSTADJCP 
ISTCDRDY 


TSTDSWMN 


ADDRESS 
RPRDAF 
ADDRESS 
RPRDAF 
ADDRESS 
RPRDAF 
ADDRESS 
RPRDAF 
ADDRESS 
RPRDAF 
ADDRESS 
RPRDAF 
ADDRESS 
RPRDAF 
ADDRESS 
RPRDAF 
ADDRESS 
RPRDAF 
ADDRESS 
RPRDAF 
ADDRESS 
RPRDAF 
ADDRESS 
RPRDAF 
ADDRESS 
RPRDAF 
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RDTSUM Analysis 


OOCCIABO RPRHDTYP 02 
0000000900000 RPRCURST 
QOCC1B60 RPRHDTYP 02 
Q00000010001 RPRCURST 
Q0CC1D70 RPRHDTYP 02 
000000010002 RPRCURST 
OOCCIEDO RPRHDTYP 02 
000000010003 RPRCURST 
Q0CC2030 RPRHDTYP 02 
©00000010005 RPRCURST 
Q@0CC2190 RPRHDTYP 06 
000000010006 RPRCURST 
Q@OCC23A0 RPRHDTYP 02 
000000010008 RPRCURST 
©0CC2598 RPRHDTYP 01 
000000010000 RPRCURST 
00CC2740 RPRHDTYP 01 
000000000000 RPRCURST 
QOCC27C8 RPRHDTYP 07 
Q00000000000 RPRCURST 
Q0CC2870 RPRHDTYP OF 
000000000000 RPRCURST 
Q@2CBDF58 RPRHDTYP 07 
000000000000 RPRCURST 
Q2CBEF40 RPRHDTYP 04 
Q00000000000 RPRCURST 


ARDT scceawe Det sce ef 


RPRENTRY 02 APPLICATION HDR 


0505 
RPRENTRY 
0505 
RPRENTRY 
0200 
RPRENTRY 
0505 
RPRENTRY 
0505 
RPRENTRY 
0505 
RPRENTRY 
0505 
RPRENTRY 
0505 
RPRENTRY 
0505 
RPRENTRY 
0505 
RPRENTRY 
0505 
RPRENTRY 
0505 
RPRENTRY 
0505 


11 


07 


04 


ACTIV 

CDRM 

ACTIV 

APPL 

CONCT 

APPL 

ACTIV 

APPL 

ACTIV 

CDRM 

ACTIV 

APPL 

ACTIV 

PU _T4/5 

ACTIV 

GROUP 

ACTIV 

CDRSC SEGMENT 
ACTIV 

ADJCP MAJ NODE 
ACTIV 

CDRSC SEGMENT 
ACTIV 

SW SNA MAJ NODE 
ACTIV 
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ROUTES 
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Use ROUTES to display explicit route table entries (ERTEs) and virtual route block 
(VRBLKs). | 


Operands 


None. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


>>—ROUTES $A 


Sample Output for ROUTES 
ROUTES 
ROUTES Analysis 


ERTE: 067C7020 
ERTPTR... Q0000000 ERTERN... 00 ERTFLG... 00 ERTTGN... 01 
ERTADJSA. 00000001 ERTDSA... 00000001 

DATA: 067C7020 
+0000 14280000 00000000 O0C70000 0008000 | ......... Gesesce | 
+0010 0000000 00000001 00000001 0000001 | ............eeee | 
+0020 00000000 0000000 LU cataoaaee | 


ERTE: 067C70E0 
ERTPTR... @67C7QBO ERTERN... 05 ERTFLG... 00 ERTTGN... 01 
ERTADJSA. 00000004 ERTDSA... 90000002 

DATA: 067C70EO 
+0000 14280000 067C70BO 05830000 00004000 | .....@.[.c.... . | 
+0010 00000000 00000001 0000004 0000002 | ............e05. 
+0020 00000000 0000000 P iteociedies | 


ERTE: 067C70B0 
ERTPTR... 067C7080 ERTERN... 02 ERTFLG... 00 ERTTGN... O1 
ERTADJSA. 00000004 ERTDSA... 00000002 

DATA: 067C70BO0 
+0000 14280000 067C7080 02830000 0008000 | ..... OcCsseueac | 
+0010 00000000 00000001 00000004 OQ000002 | ............eeee | 
+0020 90000000 00000000 Bere | 
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VRB: 062FE580 
VRBADJSA. 00000001 VRBFXCHN. 00000000 VRBDSTSA. 00000001 VRBVRN... 00 
DATA: 062FE580 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
+0090 
+00A0 
+00B0 
+00CO 
+00D0 
+00E0 


05E80000 
11280000 
00000000 
00C1C610 
00000000 
00000000 
00000000 
00040000 
05000100 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


VRB: 062EE268 
VRBADJSA. 00000004 VRBFXCHN. 062EE360 VRBDSTSA. 00000002 VRBVRN... 03 
DATA: 062EE268 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
+0090 
+00A0 
+00B0 
+00CO 
+00D0 
+00E0 


05E80300 
11280000 
00000000 
00C1C610 
00000000 
00000000 
00000000 
00000000 
01000100 
00000000 
00000000 
00000000 
00000000 
03000000 
00000000 
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00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000001 
00000001 


062EE360 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
Q0000C18 
00000000 
00000000 
00000000 
00000000 
00000C18 
00000002 
00000001 


00000001 
062FEE88 
00000000 
1B081000 
00000000 
05000000 
00360000 
00000000 
00000000 
00000000 
05000200 
00000000 
00000000 
00000000 


00000004 
062FEE88 
00000000 
18081000 
00000000 
01000000 
00000000 
00000000 
00000000 
00000000 
01000200 
00000000 
00000000 
00000000 
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00000000 
00000000 
00000000 
00000018 
00000000 
062E7100 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


00000000 
00000000 
00000000 
00000018 
00000000 
00000000 
00000000 
90000000 
00000000 
Q0000C18 
00000000 
00000000 
00000000 
00000000 


eeeeeees 


eeeeoeesee#se 
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Use SES to format the RDTE specified by name, and all SIBs and RDTEs in 
session with name. The specified name can be any session endpoint, such as a 
logical unit, terminal, or application program. It also formats: 


ACDEBs 
APPCBs 
COPRs 
FMCBs 
FMCBEXTs 
HSICBs 
LUCBs 
NSICBs 
NSSCBs 
RABs 
SABs 
SIBIXs 
SIBRXs 
SIBXs. 


If name is not specified, SES formats all SIBs, RDTEs, ACDEBs, APPCBs, COPRs, 
FMCBs, FMCBEXTs, HSICBs, LUCBs, MPSTs, NSICBs, NSSCBs, PSTs, RABs, 
SABs, SIBIXs, SIBRXs, and SIBXs. 


Operands 
RDTE Name 


The RDTE name should be 1-8 alphanumeric characters. If it contains fewer 
than 8 characters, it is padded on the right with blanks. The specified RDTE 
can be any session endpoint, such as a logical unit, terminal, or application 
program. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


pme—SES 
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RDTE (name) 
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Sample Output for SES: 


SES 


MPST: 86814038 
MPSCHAIN. G6B140B8 MPSPSTQ.. @28298E8 
DATA: 60814038 


+6600 
+6610 
+0620 
+8030 
+6640 
+0050 
+6660 


D4D7E2E3 
66F74606 
7FFD6460 
62921806 
6602686CA 
@GFECE8O 
6666000 


PST: 028298E8 


+6660 
+6010 
+0020 
+6636 
+6046 
+0056 


61606486 
69660008 
66660000 
06006608 
61011666 
66606060 


ACDEB: @280£146 


ACOTCB... @68F1D18 ACDCHN. 


DATA: 0286£146 


+8000 
+6016 
+6020 
+9630 
+6646 
+0056 
+0060 
+0670 


0F 166000 
66600000 
206166060 
06884938 
66060000 
068F1D18 
66066660 
66600660 


LUCB: @291F3D0 


+0000 
+0616 
+6028 
+0030 
+0046 
+6050 
+0060 


5268004F 
60006668 
00660660 
0280E140 
68660600 
O@B1A588 
66066668 


APPCB 0286E258 
APPLUCB 0291F3D0 


86600@ 62C1D7D7 
060620 31694600 
600046 66600000 
066060 ESF2F3F4 
806086 960068000 
Q88GGAG 68G68000 
Q@G66C@ O2912AA6 
6668E6 60666600 
606166 60660600 


FMCBX: 627E9B50 


+6600 
+8010 
+6620 
+8036 
+8040 
+8050 


66666667 
00060667 
66066666 
30666600 
40464640 
66008000 


FMCB: @28FBAA8 


+6666 
+0610 
+6626 
+6630 
+0046 
+0656 
+0060 
+0076 


632C8600 
62810998 
92969270 
86660666 
96060606 
35086666 
01016618 
66086886 


6600000 
028298E8 
02921836 
66808658 
06814038 
66606600 
02825240 


06006066 
666866066 
O8GG068EA 
66060000 
06660030 
6660080 


02913E60 
66660060 
06060010 
02913E60 
66600060 
62913E60 
60666060 
66606066 


66666000 
86006600 
O2CFFE20 
0286E258 
60060000 
60060006 
66666660 


SES Analysis 


66B14DB8 
@29137D0 
628298E8 
eeeeeeee 
81263308 
0006000 
06666606 


028298E8 
96606006 
668D7C50 
8OB1A844 
66660800 
6681A848 


028298E8 
@6B1A590 
66060600 
06606600 
66090600 
66666060 
6291F3D0 
6666606 


628298E8 
6286C618 
027E9B50 
6600666D 
68000600 
19611060 


APPTSKID 628298E8 
APPSPTAE 029129B0 62912AF@ 62912AA6 62912A56 62912A66 


665A7C13 
865A0060 
628FB976 
C1464046 
66680660 


627E9B56 
egece6Ge 
666000080 
0666006 
66666066 
66660646 
eeeeeees 
86006060 


1666628 
66676056 
@28FBBEG 
46464046 
66668066 


628298E8 
86066060 
1€616666 
60066660 
62969698 
66660606 
66006000 
66660066 


00700012 | MPST..... £(%.... | 


pesDB5es | .7...bqY.j.}.-eY 
62913700 | "....k...bqY.j.} 
62913708 Re letiates’ j.} 
90814056 | ..-..£(.a..Q.£(& | 
peeeeeee =| ..6............. 
eeeeeeee | ..... bis esewenes 
00814038 | /........ baY.£(. | 
60000000 | ............00ee 
eeegeeee | ......... 4... 
eoeeceee | ......... £Y cess 
eeeeecee | ele a teeraanatats 
gegeeeee | ......... £Y.... 


996006000 | weevedo=sbaYe.s: | 
eee0eeee 

geoeeeee | ............005. 
e9eee0eB | .»...j.-........ 
62825240 | ........eeeee b. 
g9e0e608 | .ffi...j.-........ 
99008000 | pide s 43) ece% | 
eee9eee8 


eevee reneoeeeenes 


61FDE006 
628F7798 | ......... =E&.ffi.g | 
627E9B5@ | ... ..S...... = 

@GG00000 | ............eeee 
e9ee0e48 | .£vh.,.......... | 


99000080 | thal alee bqY.... | 


APPACB 606884938 APPLUN 722345678 


8291F3D0 628298E8 66000000 eeeeeeee B6888009 024110Be 9008808 
96000016 BEeeGeGe GE0e6060 61016618 60066606 66884938 62916268 
8668608 G6606660 HeOGeReE GBO6E6E6 BOHGHEEG HEEEECCE EoEGEGEC 
F5F6F7F8 88080688 G6000G66 06606006 866660600 627E8748 627E1228 
O2938AFC 88888808 GEGG0080 86660606 62825248 eeeeeeee GOeGG00E 
68666660 623FBGA8 66006606 36206600 G66886AG 029129B6 62912AFO 
62912A56 62912A66 66800000 886666800 B6066688 GEEGHGEN 86600000 
88000006 66808808 GeG00600 eeGeceee eG888R0O GEEEeECe GeEGEOEE 
66066060 


627E9826 
geaesese | ..... fix. fA)... | 
D5C5E3C2 | re, | NETB 


@28FBAAB | Siae | fh.y | 


66600006 


eeeeeeed | ence =E&.bqY.... | 
eeeeeee 

peeeee18 | ..k....... Sars 
G0000G08 | .......... ecco | 
geoeeeee | ......... -0g.... | 
pe0ee6ee | ..-.... .....00. | 
eee8eeee | fentaeu Daa pama hue | 
61006028 


ee 
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* ew @eeeeveereeeeveeeeaeeereeneeeeeveeesd * 
* eeeeeroeoeoeecoeeee @eevoeeveeeoreevoeo oe® 
#Z2545678. occ eccccccccvcves soeee® 
Wr cc err ae evar e reser ceses Ceseeces * 
Weccvccccscoccesevsune ev eccccees @* 
Re cecccccescencecs @ewseovowe eewose® 
eee are ee ere eee eeeeceCopeeaeeeeevte * 
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eoeeeeoseos 


Chapter 7. Using VTAM Dump Analysis Tools (MVS) 


SES 


309 


SES 


HSICB 027E6248 
HSISENSE 86060000 
HSIHLDPS 86600000 


HSICONID 61600628 
HSIFMHST @6006000 


06600 62C8EZC9 EeR0EG8R 61600028 66000000 
966020 6e88G008 GNGHeG0e BeGGGE8E GG000000 
060040 86060060 66018003 60800148 666006000 
666060 eeGeDEGe GEeG0GGee GG8GG0GG 80000000 


SAB 027E8748 


SABLRMFL 60 
SABNSFG2 60 


SABSHARE 80 
SABNSFG1 63 


606000 62E2C1C2 eeeGeG00 B8G0GG00 61600028 
060026 46404040 C1F2F3F4 FSF6F7F8 80603000 
606046 66000000 GOBB19BC 637518D5 9e000000 
806060 60000000 66000000 627£8288 90600000 
60080 90000000 GG0000G0 86000000 


RAB 027£1228 
RABCONID 61006628 RABSABPT 627£8748 
686600 62D9C1C2 98808000 628298E8 Ge000800 
6066020 46404046 C1464040 46404040 C1F2F3F4 
006040 86600000 60000000 62411084 60000000 
066666 0161001B eeG0e0G0 GEGEGEEE 61008802 
866686 606001060 GeeGeG0e GEH8000R 90000000 
@OGGA0 888EG000 G08GEG00 60000000 90000000 
@900CO 68800068 90008008 BeRGEGEN GOGE0R0 
Q@GGG6EG eDEOGCGO HE0GEOGG 6280E258 86000000 


QAB: 6295A738 


+6060 D9C4E340 66600000 GO6B17AB@ 62CFFS8O8 


+6010 606100008 60766074 


RDT: 00817AB0 
RPRNAME.. VTAMSEG RPRENTRY. 62 
RPRDEVCH. 88000006 60000000 

DATA: 90B17AB0 
+6000 E5E3C1D4 
+6010 60000680 
+0626 90060008 
+6030 060000060 
+6040 00020001 
+8058 66066600 
+6068 60060000 
+6070 96818598 
+6686 086000000 
+8098 60000000 
+00A0 96000060 


E2C5C746 
696060000 
06000080 
66066600 
96600008 
06666006 
66608606 
6295A738 
66600000 
66600600 
66009600 


86060000 
06600008 
06066000 
6000600 
6000600 
6660008 
20606600 
ee6e0cee 
66000600 
66006600 


RDTE: 66B17B66 
RPRNAME.. SSCP7B RPRENTRY. 11 
RPRDEVCH. C@6D06066 66800060 

DATA: 60817B60 
+0666 E2E2C3D7 
+6010 90000000 
+0020 60817BC8 
+6030 60B817AB0 
+6040 60000069 
+8656 60000000 
+6660 60006000 
+6676 60000060 
+6086 60000000 
+6696 96000060 


F7C24640 
60670001 
60660210 
66666606 
49060160 
66060060 
9606006 
60600060 
66600060 
3F013F01 


86000006 
06626609 
066606B6 
06006606 
6660660 
C6606600 
06600000 
66008060 
66600606 
6006660 
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HSIBIUIN @BA10115 
HSIPACQ 60000000 


SABFSM 30 


RABFSM = 1 


06026200 
60617818 
60060600 
65050505 
eeeeeees 
e606ec08 
66060660 
06000060 
66066600 
60060660 


06116266 
66B17C5C 
60660000 
€5050565 
e6060000 
0860060 
6000008 
06060068 
66066060 
06086000 


HSISENDQ 86600000 


86666080 66600000 8BA16115 98800001 
6080006 66000008 GG6G0808 80E00000 
80608000 66660806 G90008G6 GG600000 
00606064 66060000 88600800 980000000 


SABSENSE 606006600 


027E1228 D5C5E3C2 406404046 (1464046 
66606008 60000060 027£8288 eeGeeORO 
08660366 6900006 96060000 86000080 
86060006 60600080 88000008 88000000 


RABCRPLA 90066600 


80666006 61660628 81000028 D5C5E3C2 
F5F6F7F8 AS49A1A3 627E8748 66800000 
32694086 90000046 0008000 88000000 
86669608 96800888 86000008 60600000 
08000001 60006000 GG000808 0000000 
06606080 96060000 86040188 88666080 
eeeoeeee GoG0880e BEGOGNHE 62000000 
06668600 60960000 


RDT .....£:[..8. 


eoveseee 


RPRBITAN. 02660160 66 


RPRBITAN. 66600946 60 


eeenenee 


| SSCP7B 


e@oeve ceeoseeresosen 
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WAST ccewcurles- cee ee ae y ssa eee * 
Fe 56 Ba 80: SNS 0-006 Www 009 1678 0h ee 16 xe 0 eS * 
Weowecreccess covcesesecnseccscscece * 
ee ee eee ee eR eR ee * 
* SAB... cee eeee oceee NETB A * 
* A2345678....ccccccccccccccee® 
Fesevccccees No cccccccevccvcccccee®™ 
Kees e@eseevened @eoeee e@eeeevenveane * 
* * 


eoereseeoeevecesn 


* RAB... ee Vincccccvcscccece NETB* 
* A A2345678........000% * 
Wig. w Wiel oi eia lee ievevecateectre. 1a e768: Cover ere eoee® 
We cevccercccccvceserccrscecsecnces * 
Meee crcsccreseavccerecseserseceoes * 
Wie cccccccscevsccevenseene eeneece * 
Mime a cececceceerocererrescecesons * 
Becccpecces Siete sec miens * 
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SIB: 62CE21D0 
SIBFSMIN. FC SIBFSMTM. 60 SIBFSENS. 06060066 
SIBBPRIQ. 62CE1D38 SIBBSECQ. 62CE1D38 SIBTTMFL. 66 SIBTREAS. 60 
SIBTSESE. 60 
SIBPCID = C2BB19BC037518D06 QUALIFIER = NETB.SSCP7B 
DATA: 62CE21D0 


+0060 9806FC@G G00e8eGG C2BB19BC 63751806 D eee Bt. 60 | 
+0816 46404646 40404046 58404640 40464046 $ 

+0620 58404646 46404046 A549A2FC 3F762104 $ ViS seve 
+0636 62CE2048 60000080 O2CE1D38 62CE1D38 Pa Perper 6...6.. 
+6046 90606000 @2CE2296 O2CE22F@ 62C77054 o+eee6...6.0.G.. 
+0656 50311660 60000008 66660600 60000600 errr (sages 
+8066 66000680 6800000068 84000060 60000000 | ........ ne 
+0676 99000808 eGeG00e0 BHeeeGee H808000O | ................ 
+6686 66006066 80600000 86000008 G0000000 | ..............-. 
+6698 96600006 eG080G00 G80G080G G00RGG0N | ................ | 


SLU (OLU) RESOURCE 
SIBRX: 62CE2270 
SIBRADJN. ........ SIBRALNM. ........ SIBRNID.. .......- 
SIBRNETA. E3C24048 4040 
SIBRNETC = 06 = SIBRNTU - Unknown 
DATA: @2CE2270 
+9900 @8006808 eeeeE88e e8eGGee08 eHREGGEE | Bek Ne ot Mira | 
+0016 96008008 e8egee8e BaeHHEee eONaECNE 
+9626 9e@e98e80 ebeGe080 7(404040 40494040 
+0030 DS5C5E3C2 46404040 99000080 O2CFFSBE 
+9046 @6000080 60107350 


eoeoereeereneereaeeese 


SLU (DLU) RESOURCE 
SIBRX: 62CE22B8 
SIBRADJN. ..a..... SIBRALNM. ........ SIBRNID. nesses 
SIBRNETA. 66666600 6666 
SIBRNETC = = Network configuration has an undefined value 
DATA: 02CE22B8 
+0600 78608160 9ee60088 8eGeGeGe 86000000 | Lous a wane aaa ee 
+0616 909000800 e80e0086 eeGe8eG8 eeeeeGeG | ................ 
+9026 @98G0800 66070058 ee9e0000 eegee0e0 | ....... Sica oie: 
+0636 96006068 66006886 688600860 66600606 | OTT ere eee eee | 
+8046 78404846 464046406 # 
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SIBCHECK 


SIBCHECK analyzes important fields and relevant status flags in an SIB and 
related control blocks. The following control blocks are analyzed: 


SIB base 

SIB initiation extension (SIBIX) 

SIB termination extension 

PLU resource extension (SIBRX) 
SLU resource extension (SIBRX) 
OLU cross-network extension (SIBX) 
DLU cross-network extension (SIBX). 


SIBCHECK determines: 


Originating logical unit 
- Destination logical unit 
Initiating logical unit 
Primary logical unit 
Secondary logical unit 
RDTE address 
Resource type (APPL, LU, CDRSC, and so on) 
Configuration (cross-domain, cross-network, back-to-back, and so on) 
Real resource names and network IDs 
Alias resource names and network IDs 
Network addresses 
GWNCP names. 


For each status bit in the SIB and related control blocks, the bit name, its value, 
and its meaning (from VTAM Data Areas for MVS/ESA) are listed. 


Fields in the SIB that contain addresses are checked (such as SIBTV35P, the 
CV35 pointer, or SIBTNOTP, the pointer to NOTIFY RU). If these fields contain a 
nonzero address, the address and description of the field are also displayed. 


_ Note: The SIBBTIME value is displayed in the format of Coordinated Universal 
Time (formerly known as Greenwich Mean Time). 


Operands 


You must specify one address or one symbol. 


Address 
Enter 1-8 hexadecimal digits in the form X'x...' for the address of the SIB to 
be analyzed. If the address is fewer than 8 digits, it is padded on the left with 
zeros. 


IPCS Symbol 
Enter 1-31 alphanumeric characters for an IPCS symhol name that has been 
previously equated with the address of the SIB to be analyzed. Do not include 
a period. 


Under IPCS, the symbol X represents the address currently being displayed. If 
the current address is an SIB, this symbol may be used to refer to it. 


Use the following syntax as an alternative to the panel interface. 
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Syntax 
b>—SIBCHECK—— 


SIBCHECK 


ADDR (address )}— + 
SYMBOL (symbol) 


Sample Output for SIBCHECK 


SIBCHECK ADDR(X'62CCA620' ) 


SIBCHECK Analysis 


CDORM: VTAM 
NetID: NETA 
Network address: 00000001 0001 
SIB address: O02CCA020 
OLU| PLU DLU| SLU 
Name (from RDTE): APPCAPQ5 Name (from RDTE): APPCAPO6 
RDTE address: 02CC7B7C RDTE address: O02CC7CD8 
RDTE type: APPL RDTE type: APPL 
Owning CDRM: VTAM Owning CDRM: VTAM 
NetID: NETA NetID: NETA 
Alias name: APPCAPQ5 Alias name: APPCAP06 
Alias netid: NETA Alias netid: NETA 


Adjacent SSCP: 


Adjacent SSCP: 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


00000001 O0OF Network address: 00000001 0012 
SIBIFSST - Pending generic session start state 
SIBTFSIS - Initial state 


Network address: 
SIBFSMIN: F4 = 
SIBFSMTM: 00 


Analyze SIB Base 
Original PCID for session: 
Timestamp from SIB (SIBBTIME): A94FBAF5FD484FF1 
Converted Timestamp (SIBBTIME): 08/13/92 12:36:29.816279 
Primary SIB queue (SIBBPRIQ) elements: 0 
Secondary SIB queue (SIBBSECQ) elements: 0 
SIBBAUTO = © - This is not an AUTOLOGON (LOGAPPL) session 
SIBBIOLU = 1 - OLU is the initiating LU 


D5376DF4EAS8AABO | 


Analysis of resource extension for DLU|SLU APPCAPO6 at address 02CCA140 

SIBRNETC = 10 = SIBRNTS - Network configuration: Same domain 

SIBRCDTC = @ - Session has not been associated with the CDTAKEDOWN complete 
RU for the CDRM specified in SIBRADJN 


tft 


Analysis of SIB Initiation Extension at address 02C6D020 
Routing FSM (SIBIRFSM): 20 

Failing RU (SIBIFRU): 00000000 

Failing reason (SIBIFRSN): 00 

Failure status (SIBIFST): 00 

SIBICDR = 0 - CDINIT DQ is not waiting on any 1/0 
SIBIDLUA = © - The DLU network ID is not assumed 


Analysis of SIB Termination Extension | 
RID for session takedown (SIBTTRID): 0000000000000000 
Process RID (SIBTTRID): 0000000000000000 
Q - Session was not suspended for duplicate session 
Q - SIBUSER - Termination originator is network user 


SIBTDSUS 
SIBTORIG 


Cross-network extension does not exist for OLU|PLU APPCAP@5 


Cross-network extension does not exist for DLU|SLU APPCAPQ6 


Chapter 7. Using VTAM Dump Analysis Tools (MVS) 313 


SPANC 


SPANC 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


SPANC analyzes any or all of the VTAM storage pool anchors (SPANCS). If you 
use no operands, the number of pages in use, the page size, and where the 
storage is allocated (common or private) for every SPANC pool are displayed. 
Options are available to: 


e Designate a specific SPANC pool to be analyzed 
Determine the number of FBQEs on each page 
Determine the size of each FBQE on each page 

Display a sample of storage from each page 

Determine the page addresses associated with pool(s) 
Process data in a specific pool through the use of an exit. 


Operands 


| Pool 


Specify the name of a specific SPANC pool to be analyzed. If the pool 
operand is not used, all SPANCs are processed. If a pool name other than 
one from the list of valid pool names is specified, no output will be produced. 


Note: Pools named 'AVAIL' are not valid and are used only as place-holders. 
They are displayed in the event storage overlays occur. 


Note: The FBQE Count, FBQE List, Process, and Exit operands are mutually 
exclusive; use only one of them. 


FBQE Count 
Specify Y to have the number of FBQEs on each page of the selected pool (or 
all pools if no pool was selected) listed. The FBQE contains the length of the 
free storage it describes. Use this option for performance or storage fragmen- 
tation problems. Long chains of FBQEs can cause VTAM performance prob- 
lems. 


FBQE List 
Specify Y to have each FBQE on each page of the selected pool (or all pools if 
no pool was selected) listed. The FBQE contains the length of the free storage 
it describes. Use this option for storage fragmentation problems. 


Length 
Specify the number of bytes of storage you want displayed from the beginning 
of each page of the selected pool (or all pools if no pool was selected). Any 
hexadecimal number from X'001' to X'FF8' or any decimal number from 1 to 
4088 may be specified. Use this option to get a sample of storage from each 
page of a specific SPANC pool. 


Process 
Specify Map to display the address of each page that is associated with the 
selected pool (or all pools if no pool was selected). Use this option in conjunc- 
tion with VSMDATA to determine the SPANC pages mapped by each MVS 
subpool. 


Exit 
Use Exit to have one of the four exit functions process information on each 
page of selected SPANC pools. Specify exit FMCB, RU, RUPE, or SIB. 


1. The FMCB exit searches SPANC pools FMCB, PLUSFMCB, or 
SSCPFMCB for FMCBs and formats those found. 
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2. The RU exit searches SPANC pools UTILCSAS, UTILCSAL, UTILPVTL, or 
UTILPVTS for all RUs or a specific RU on a page of storage and displays 
the address and data for those found. 


Note: These pools may contain data which is not an RU. To locate a 
specific RU, specify the actual RU in the Value field, a Type of X, anda 
displacement of X'06'. 


3. The RUPE exit searches SPANC pools RUPECOMM or RUPEPRIV for all 
RUPEs in the pool. SPANC displays the RUPE address, CPCBOPC, 
RUPEOAF, RUPEDAF, and RU data for those found. 


4. The SIB exit searches SPANC pool SIB for all SIBs in the pool. SPANC 
displays the SIB address, FSMs, sensecode, PLU NetID, PLU name, SLU 
NetID, SLU name, and procedure correlation identifier (PCID) for SIBs that 
are found. 


Note: For all EXIT routines, an address followed by an asterisk (*) indi- 
cates that the buffer pool is allocated. 


Note: The following three operands, Displacement, Value, and Value Type, must 
be used together with the Exit operand. The Exit operand may be used alone. 


Displacement 
Enter the displacement into the data portion of a page where Value is to be 
found. The maximum decimal displacement is 4095, and the maximum 
hexadecimal displacement is X'FFF'. 


Value 
Enter a character, hex, or binary value to be searched for at the displacement 
specified by Displacement. 


Value may contain character or hexadecimal data of 1-8 bytes in length. Char- 
acter data should consist of alphanumeric characters. Hexadecimal data 
should contain an even number of hexadecimal digits in the form X'xx..', oth- 
erwise, the high order half-byte is assumed to be zero. 


Binary data can be used to look at a particular bit within a byte. You may 
specify one byte of binary data in the form X'xx'. Only 1 bit within the byte 
may be selected. Therefore, you can specify only the following hexadecimal 
values: 01, 02, 04, 08, 10, 20, 40, and 80. A value with more than 1 bit set 
(for example, 82) will not be accepted. 


Value Type 
Enter B for binary, C for character, or X for hexadecimal to indicate the type of 
data entered for Value. 
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Use the following syntax as an alternative to the panel interface. 


Syntax | 
POOL (ALL) FBQE (NV) —— FBQELIST(W) 
a 
POOL (pool_name) FBQE(Y) FBQELIST(Y) 
MAP (N) 
L LEN(Iength)— E ee 


DISP(displcmnt)— VAL(value)— TYPE(data_type) 


Sample Output for SPANC 
SPANC 


SPANC Analysis 


Pages in use for pool RUPEPRIV 1 Page size = 00010000 PRIVATE 


Pages in use for poo] RUPECOMM = 1 Page size = 00001000 COMMON 
Pages in use for pool SIB = 1 Page size = 00010000 PRIVATE 
Pages in use for pool SSCPFMCB = 1 Page size = 00010000 PRIVATE 
Pages in use for pool AVAIL = 0 Page size = 00001000 PRIVATE 
Pages in use for pool EPTDVT = 2 Page size = 90001000 COMMON 
Pages in use for pool UTILFIXD = ) Page size = 00001000 COMMON 
Pages in use for pool POWMPRIV = 2 Page size = 00001000 PRIVATE 
Pages in use for pool POWMCOMM = 0 Page size = 00001000 COMMON 
Pages in use for pool POAPRIV = 0 Page size = 00001000 PRIVATE 
Pages in use for pool BFRTRFUL = 0 Page size = 00010000 COMMON 
SPANC POOL(SIB) EXIT(SIB) 
SPANC Analysis 

SIB ADDR FSMs Sensecode PLUNETID PLUNAME SLUNETID SLUNAME PCID 

O2CCAQ2Z0* F400 00000000 NETA APPCAPO5 NETC APPCAPQ6 05376DF4EA88AAB 
Matches found in exit = 1 

Pages in use for pool SIB = 1 Page size = 00010000 PRIVATE 
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SPANC POOL(FMCB) EXIT(FMCB) 
SPANC Analysis 


02908028* 
TSPLNGTH 2C¢ TSPEPTA Q291A1FO TSPDEBA 02923140 
TSPTCFL1 OC TSPPSFL1 00 TSPSTAT1 8000 
FMCB: 02908028 
+0000 032C8000 02907028 0292A3D8 0000000 | ......... ktQ.... | 


+0019 0291A1F@ 80000000 90000000 O0E00000 | .j 0............ | 
+0029 02919270 90000000 1C016000 00000018 | .jk....... ee | 
+0030 00000080 00000000 00000000 0000000 | ................ | 


+0040 90000000 80000000 02919040 oepgg000 | ......... Te: ee | 
02908160» 
TSPLNGTH 2C TSPEPTA Q291A1FQ@ TSPDEBA 02923370 
TSPTCFL1 DC TSPPSFL1 00 TSPSTAT1 0000 
FMCB: 02908160 
+0000 032C0000 62907080 O292AE88 0000000 | ....... Loken Secce:| 


+0016 9291A1FO 00000000 0000000 e0000000 | .j 0............ | 
+0020 02919270 90000000 1C016000 90000018 | . 
+0030 00000000 0000000 0101001D 0101001D | ................ | 
+0049 00000000 00000000 02919040 99000000 | 

Matches found in exit = 2 

Pages in use for pool] FMCB = 1 Page size = 00010000 COMMON 


SPANC POOL(UTILPVTS) EXIT(RU) 
SPANC Analysis 

RU ADDR RU Data 

02C72020 0£990000000100 

02C64020* O00000930DD5C5E3C14BE3C8C9EZC8D6EZ2E30000000000000000000000000000 
02(C64048 0000001F0019D4D6C4C9C6E840C9C47EC4C1E5C56BE3C102D3C54040404040 
O2CBBO20  9000003D0037810680104002020060E2D5C1E2E5C3D4C7 F308C1D7D7C3C1D7 FO 
02C74020 000£1C1C92C6709002C6706802C6706800000000000000000000000000000000 
02C740A8* 0000005F00598106200302D537 6DF4EA88AABO0G0000000006F308C1D7D7C3C1 
Matches found in exit = 6 

Pages in use for pool UTILPVTS = 4 Page size = 00001000 PRIVATE 


SPANC POOL(RUPEPRIV) EXIT(RUPE) 
SPANC Analysis 
RUPE ADDR Op code RUPEOAF RUPEDAF RU Data 
02C€53020* 08810620 000000010001 000000010010 REQ=8106200302D5376DF4EA 
02C530CO« 06F310000 O0000001000F 000000010012  REQ=31001307B0B050B30080 
02C53160* 9F310000 O0GDON001000F 000000010012  REQ=31001307B0B050B30080 
02C53200* 04000000 000000010003 000000010003 REQ=C4C9E2D7D3C1E840C9C4 
02C532A0 04000000 000000010003 900000010003 
02C53340* 68319000 Q0000001000F 000000010012 REQ=FF310281A02801880002 
Matches found in exit = 6 
Pages in use for poo] RUPEPRIV = 1 Page size = 00010000 PRIVATE 
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Use SRTFIND to locate a symbol resolution table entry (SRTE) in a dump. 


Note: An attempt is always made to translate a symbol or a string regardless of 
the quality of the input data stream. The translation may produce unexpected 
results such as dots, random letters, or other combinations of symbols. 


Operands 

SRT Name 
The SRT name is the symbolic name of a symbol resolution table (SRT) entry 
and can be entered as alphanumeric characters or hexadecimal digits. 


e If alphanumeric characters are used, enter 1—8 characters in the form cccc. 
If fewer than 8 characters are entered, the name is padded on the right 
with blanks, and the tool will search only for the characters entered. 


For example, if APPL1 is entered, and APPL1, APPL1A, and APPL1B 
exist, the tool will find only APPL1. | 


e If hexadecimal digits are used, enter an even number of digits from 1-16 in 
the form X'xxxx'. If fewer than 16 digits are entered, the name is padded 
on the right with blanks. If an odd number of digits is entered, the name is 
padded on the left with a zero. 


For example, if X'00000010001 ' is entered, the tool will search for 
X'0000000100014040'. 


The SRT name is required. 


NetID 7 
The NetID name representing the network ID of another network outside the 
host network where the resource resides should be 1-8 alphanumeric charac- 
ters. If it contains fewer than 8 characters, it is padded on the right with 
blanks. 


Type 
Using the name or hexadecimal value, enter the type of SRTE for which you 
are searching. The default is RDTE. Enter hexadecimal values in the form of 


X'xx'. 


Chain 
Use Display SRT Chain to display all SRTEs on the chain, regardless of other 
search criteria. This option may help locate an SRTE whose storage has been 
corrupted. The default displays only the SRTEs that match all specified search 
criteria. 


Note: Chain overrides the setting for Process. 


Format 
.Use Format to have selected data formatted using the SRT control block. 
Noformat, the default, displays the SRT's name, address, and type. 


Process 
Use All or First to find the SRTs that match the search criteria. The default is 
All. First displays only the first SRTE that matches the search criteria. 
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Equated Symbols 


Symbol Description 
ISTSRTsrtname SRTE 
ISTSRTDsrtname  SRITDATA (if present) 


Use the following syntax as an alternative to the panel interface. 


Syntax 


TYPE (RDTE) NOCHAI 
p>—SRTFIND— SRTNAME (name) 
NETID(netid) TYPE (name ) CHAIN 
TYPE (value) 
: ———] E 4 
FORMAT FIRST 


Sample Output for SRTFIND 
SRTFIND SRTNAME(SSCP1A) FORMAT 
SRTFIND Analysis 
SRTE SSCPIA was found at address X'8QBFO2C8' with type RDTE 


SRT: 80BFO2C8 
SRTSYMNM. SSCP1A SRTSRTE.. 82DA0100 SRTTYPE.. 00 
SRTSRTE: 80BFO2D0 
+0000 SPECE.... 82 
DATA: 80BF02C8 
+0000 E2E2C3D7 F1C14040 82DAQ100 00550200 | SSCPIA b....... | 
+0010 00040000 ee 
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STORAGE 
Use STORAGE to format BPCBs, BPDTYs, PXBs, SPANCs, and SPTAEs. 


Operands 


None. 


Use the following syntax as an alternative to the panel interface. 


Syntax 
be —STORAG En 
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Sample Output for STORAGE 


STORAGE 


BPD 


DATA: 02952000 


+0000 
+0010 
+0020 
+0030 
+0040 


Q00COO0C 
00000000 
029521A8 
Q13400FD 
00000000 


Buffer pool ID SMS1 
BPCB: 02952390 
BPCBRPHA. 00000000 BPCBRPHB. Q0000000 BPCBRPH1. 00000000 
BPCBRPH2. 00000000 BPCBAVNO. 00000000 
DATA: 02952390 


+0000 
+0010 
+0020 
+0030 
+0040 


00000000 
00000000 
00000000 
00000000 
00000000 


SPANC 02957204 
POOLNUM 0000 
DATA: 02957204 
+0000 D9E4D7C5 D7D9CIE5 O00CQD02 00000000 
+0010 00000000 00000000 


SPTAE: 0295721C 
SPTFLAGS. 10 


STORAGE Analysis 


00000000 
00002000 
QO0CC41F8 
02952054 
00000000 


00000000 
00000000 
00000000 
90000000 
00000000 


SPTALLOC. Q0000000 SPTFREE.. 
~ SPTSIDEQ. 90000000 SPTUSECT. 00000320 SPTHIUSE. 


02952508 
7FFFFFFF 
99000000 
0281£000 
99000000 


600000E7 
00000000 
02952000 
00000000 
00000000 


00000000 
02952390 
000003E8 
02957000 
00000000 


02953FF8 
00000000 
00000000 
00000000 
00000000 


POOLNAME RUPEPRIV ASSOCID N/A 


SPTNBRPG. 00000001 SPTLNGTH. 00Q0000A0 


DATA: 0295721C 


+0000 
+0010 
+0020 
+0030 


02957204 
00000000 
90000000 
00000000 


SPTAE: 0295725C 
SPTFLAGS. 00 


0295725C 
00100000 
00000320 
QO0000A0 


SPTALLOC. 00000000 SPTFREE.. 
SPTSIDEQ. 00000000 SPTUSECT. 00000000 SPTHIUSE. 


00000000 
00000000 
000003C0 
00000199 


00000000 
02053008 
00000001 
00000001 


SPTNBRPG. 900000000 SPTLNGTH. 00000178 


DATA: 0295725C 


+0000 
+0010 
+0020 
+0030 


02957204 
00000000 
00000000 
00000000 
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02053008 
800003C0 


00000000 
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Use the VITAL function to extract an internal VIT from a dump for use with the VIT 
analysis tool. See Chapter 10, “Using the VIT Analysis Tool (MVS, VM)” on 
page 411. | 


Before using VITAL, allocate a data set for the specified DD name. The data set, 
when VITAL is invoked, must have these attributes. 


RECFM=VB 

LRECL=284 

DSORG=PS 
Notes: 


1. The VIT extracted by VITAL can be used as input to the VIT analysis tool, but 
not to the IPCS GTFTRACE subcommand. | 


2. The VIT analysis tool and ACF/TAP options that rely on the timestamp might 
not run as expected because individual entries in the VITAL output have the 
same timestamp. 


Operands 

DD Name 
Specify the name of the DD statement allocated to receive the extracted VIT. 
The DD name should be a 1-8 alphanumeric character name. If it contains 
fewer than 8 characters, it is padded on the right with blanks. 


The DD name is required. 


You must allocate the specified data set before VITAL is invoked. VITAL will 
not allocate the data set for you. 


Note: The jobname field in the GTF header is set to VFDTRACE. The ASCB 
address field is set to zero. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


>>—VITAL— DDN(DD_name )—————______________________———-—-» 


Sample Output for VITAL 
VITAL 
VITAL DD(VITDATA) 
VITAL Analysis 


VITAL processing completed successfully 
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VTAM 


Use VTAM to format and display the following: 


RDT and RDTEs | 
Memory process scheduling table (MPST) and process scheduling table (PST) 


ACDEBs, APPCBs, COPRs, FMCBs, FMCBEXTs, HSICBs, LUCBs, NSICBs, 
NSSCBs, RABs, and SABs 


NCBs 


Buffer pool control blocks (BPCBs), buffer pool directory (BPDTY), pool exten- 
sion blocks (PXBs), storage pool anchor block (SPANC), SPANC task- 
associated element (SPTAE), storage pool page table (PAGTB), and storage 
pool page table entries (PTEs) 


Locked queue anchor block (LQAB) 
Waiting request elements (WREs) and event identifiers (EIDs) 


Modules from the ATCVT, in the form module name and module address, 
sorted by module name. 


Operands 
None. 


Use the following syntax as an alternative to the panel interface. 


Syntax | 
rR 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Chapter 7. Using VTAM Dump Analysis Tools (MVS) 323 


VTAM “Restricted Materials of IBM” 


Licensed Materials — Property of IBM 


Sample Output for VTAM 
VTAM 


VTAM Analysis 
BPD 
DATA: 02953000 
+0000 O00CO00C 
+0010 00000000 
+0020 029531A8 


00000000 02953508 0000000 
00002000 7FFFFFFF 02953390 
OOCC41F8 0000000 OO0003E8 | .n.y.6.8....... 


Buffer pool ID SMS1 

BPCB: 02953390 
BPCBRPHA. 90000000 BPCBRPHB. 00000000 BPCBRPH1. 00000000 
BPCBRPH2. 00000000 BPCBAVNO. 00000000 

DATA: 02953390 
+0000 00000000 00000000 600000E7 02954FF8 
+0010 90000000 90000000 80000000 eROQR000 | 
+0020 00000000 90000000 02953000 00000000 


SPANC 02958204 

POOLNUM 0000 

DATA: 02958204 . 
+0000 D9E4D7C5 D7D9CIE5 O00C0002 00000000 
+0010 00000000 00000000 

SPTAE: 0295821C 
SPTFLAGS. 10 SPTALLOC. 00000000 SPTFREE.. 02C4F008 
SPTSIDEQ. 90000000 SPTUSECT. Q00000A0 SPTHIUSE. 00000500 
SPTNBRPG. Q0000001 SPTLNGTH. QQQ00Q0A0 

DATA: 0295821C 
+0000 02958204 0295825C 00000000 0000000 | .nb..nb*........ 
+0010 00000000 00100000 00000000 02C4F008 
+0020 00000000 O000Q00A0 00000500 00000001 


POOLNAME RUPEPRIV ASSOCID N/A 


© 
© 


MPST: Q@CBED38 
MPSCHAIN. O@CBEDB8 MPSPSTQ.. 02818328 

DATA: @0CBED38 
+0000 D4D7E2E3 
+0010 00F74180 
+0020 C1E4E3C8 


80000000 
02818328 
823BA7CA 


QOCBEDB8 
0290EB18 
OOFDD6F6 


00700016 
OOAFBO40 | .7...ac...... »L | 
00160002 


PST: 02818328 
+0000 61000480 
+0010 00000000 
+0020 00000000 


00000000 
00000000 
00000051 


02818328 
00000000 
OOAF8FFO 


OOCBED38 
00000000 | 
Gee0e000 | 


QAB: 02955740 
+0000 D9C4E340 
+0010 00100000 

RDT: OOCC1ABO 
RPRNAME.. VTAMSEG  RPRENTRY. 02 
RPRDEVCH. 00000000 00000000 

DATA: O0CC1ABO 
+9000 E5E3C1D4 £2C5C740 80000000 
+0010 00000008 00000000 90000000 
+0020 00000000 00000080 00000000 


Q00D0000 
00700074 


QOCC1ABO O2CE0008 


00020200 
00CC1B18 
00000000 


RDTE: @0CC1B60 
RPRNAME.. SSCP1A 
RPRDEVCH. CQ6D0000 

DATA: Q0CC1B60 


RPRENTRY. 11 
00800000 


RPRBITAN. 00000940 00 


ATCVT: Q0CC41F8 
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ISTACCOO. 
ISTAICPT. 
ISTAPCGT. 
ISTAPCKU. 
ISTAPCPS. 


82A957A0 
823B7014 
823C(5078 
8ODDA5A0 
823C0580 


ISTACCO1. 
ISTAPCAD. 
ISTAPCIE. 
ISTAPCPC. 
ISTAPCRP. 


82ACD8B8 
823B8298 
822E29F0 
823BCE58 
822E2934 


ISTAICIR. 
ISTAPCES. 
ISTAPCIN. 
ISTAPCPD. 
ISTAPCRS. 
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ATCIOLQB 
LQAB: O2C6DF30 


VTAM 


LQABFRST. Q0000000 LQABLAST. 90000000 LQGSUBA.. 00000001 


DATA: O02C6DF30 


+0000 00000000 90000000 O2D3D8C7 00000001 | ......... LQG.... | 


+0010 90000000 00000000 


ATCLUSMQ 


LQAB: 02A3BC14 


LQABFRST. 90000000 LQABLAST. 00000000 


DATA: 92A3BC14 


+0000 00000000 0000000 O3D3D8C7 = = | ......eee LQG | 


ATCMCQAB 


LQAB: Q2A3BC08 


LQABFRST. Q0000000 LQABLAST. 00000000 


DATA: 02A3BC08 


+0000 Q0000000 O0000000 O1D3D8C7  |{......... LQG | 


ATCPULQB 
LQAB: O2A3BCB4 


LQABFRST. 0000000 LQABLAST. 00000000 


DATA: O2A3BCB4 


+0000 00000000 90000000 O4D3D8C7 = =| .......-. LQG | 


ATCNOSQ 
LQAB: O2A3BCCO 


LQABFRST. 00000000 LQABLAST. 00000000 


DATA: Q2A3BCCO 


+0000 00000000 00000000 O5D3D8C7 = | ..sauee. LQG | 


ATCSSLQB 
LQAB: O2A3BCCC 


LQABFRST. 00000000 LQABLAST. Q0000000 


DATA: O2A3BCCC 


+0000 00000000 00000000 O6D3D8C7 = —§ | .......0. LQG | 


ATCSSMQB 
LQAB: O2A3BD6C 


LQABFRST. 0000000 LQABLAST. 00000000 


DATA: O2A3BD6C 


+0000 Q0000000 00000000 O7D3D8C7 = | cacuecoee LQG | 
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VTBASIC 


VTBASIC 
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Use the VTBASIC function to display the ATCVT, the configuration table (CONFT), 
the component recovery areas (CRAs), and the VTAM internal trace (VIT). 


Operands — 

Trace output 
Enter Format to format the VIT and No format to display the VIT in 
hexadecimal format. Format is the default. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


FORMAT 
Sn a ooo 
NOFORMAT 


Sample Output for VTBASIC 
VTBASIC NOFORMAT 


VTBASIC Analysis 


VTAM INTERNAL TRACE TABLE 05F6C000 
PRESENT WRAP A6567A5FFAEE3604 LAST WRAP A6567A57BB883903 
CURRENT ENTRY 05F6C420 LAST ENTRY O5F9DFEO 


C4E2D740 12582410 02915E88 O0CC4908 O02A275F8 O2A275F8 E3EZ2E6E4 02929010 
D3D2E2C8 12000100 O0CC4C70 0000000  82A95442 Q0000000 O0000000 02929010 
E4D5D3D2 12000100 O0CC4C70 00000100  82A9546C 00000000 01000000 02929010 
D8E4C558 12482810 02915E88 00CC4248 82A954F8 O2A275F8 CID5E3D4 02929010 
C5E7C9E3 12000010 02915E88 00CC4908  82A95668 80000000 E3E2E6E4 02929010 
D9C5D8E2 12170000 02915E88 02928810  822E2E16 00010000 O290DDAQ Q0000000 
C4E2D740 12582810 02915E88 00CC4248 O2A275F8 O2A275F8 C9D5E3D4 02928810 
C5E7C9E3 12000010 02915E88 OOCC4248 82A22B1C 80000000 C9D5E3D4 029 28810 
DOCSD3E2 12170000 02915E88 02928810  822E2CB6 OO0OOOOO O290NDDAO HO0OHO0O 


ATCVT: 00CC41F8 


ATCRDT... 02955740 ATCSRT... 02C35008 ATCCONFT. OOCC18E8 
ATCBPDA.. 02953000 ATCACTRM. 0000 


GWSSCP = 


YES 


DATA: O0CC41F8 


+0000 ES5C5F4F2 
+0010 00000000 
+0020 02915588 
+0030 00CC4524 
+0040 11280000 


+07B0 00000000 
+07CQ 00000000 
+07D0 00000000 
+07E0 00000000 


40404040 FFF9O0C8 
QOOOFFFO9 11280000 
00000000 00000000 
00000000 13201000 
00000000 02915E88 


00000000 00000000 
00000000 00000000 
80000000 00000000 
06000000 00000000 


02825000 
00000000 
00000000 | .jsh... 
00000010 
00000000 | ....... 


ATCVTLOD. 02A27650 


oo000000 | ....... 
90000000 | ....... 
00000000 | ....... 
e0000000 | ....... 
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VTBUF 


Use VTBUF to analyze buffer pool control blocks (BPCBs) and obtain a status 
summary for all buffer pools or a specific buffer pool. For each buffer pool, the 
following information is displayed: 


Starting and ending address of buffer pools 
Buffer pool address (BPCB) 

Buffer type (fixed or pageable) 

Buffer size 

Number of buffers allocated 

Slowdown threshold 

Number of buffers available 

Expansion threshold 

Contraction threshold 

Number of times expanded 

Maximum number of buffers 

Expansion increment 

Expansion size 

Percentage of buffers in use 

Total number of buffers 

Bytes in static and expanded areas 

Buffers in other pools 

Buffers in static area 

Total queued request parameter headers (RPHs). 


If any expansions have occurred, the pool extension block (PXB) address, number 
of buffers available, totals buffers, beginning of the extent, and the first available 
extent are also presented. 


Operands 

Buffer Name 
Enter a 2—7 character buffer name in the form cc or ccccBUF where cccc is the 
buffer name. Counts and totals information will be displayed in decimal form. 


The default is ALL. 


Equated Symbols 
Symbol Description 


buffername BSTART Each starting buffer address 
buffername BEND Each ending buffer address 


Note: For information on the DISPLAY BFRUSE (buffer use) command, which dis- 
plays information about VTAM buffer use, see “DISPLAY BFRUSE Command” in 
VTAM Operation. 


Use the following syntax as an alternative to the panel interface. 
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Syntax 
BUFFER(ALL) 

pe VT BUF} 
BUFFER (name) 


Sample Output for VTBUF | 
VTBUF BUFFER(IO) 
VTBUF Analysis 
I0 Buffer Analysis 


Size of Buffers (bytes) 345 Buffer maximum 110 


Total buffers available 94 Static buffers allocated 110 
Total number of buffers 110 
Buffers in use (%) 15 Available static buffers 94 
Bytes in static & 

expanded areas 37950 
Slowdown threshold 5 Expansion threshold 6 
Contraction threshold 32767 
Number of expansions OQ Expansion increment 11 
Expansion size 4096 
Total queued RPHs 0 
Fixed or pageable? FIXED 
Buffer pool address X'028DB410' 
Beginning address of pool X'028F9000' 
Ending address of pool X'0Q2903000' 


Buffer pool has no extensions 
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VTCVTPAB 
Use VTCVTPAB to obtain a list of the PABs and DYPABs in the ATCVT. The PAB 
control block for each PAB is formatted. For the very extended PABs, the address 
of the first element on the PAB is displayed. The following PABs and DYPABs are 
processed: 


ATCITPAB - Internal trace DYPAB 

ATCTMRFPEB - Timer services DYPAB 
ATCCSPAB - Configuration services DYPAB 
ATCVDPAB - SSCP VARY definition PAB 
ATCPXPAB - Dynamic buffer pool expansion PAB 
ATCPUPAB - PU services PAB 

ATCPUIOP - SSCP/PU services I/O PAB 
ATCLUSRT - LU services router PAB 
ATCNSPAB - TSC no session PAB 
ATCNOSPB - Network operator services PAB 
ATCSSPAB - Session serialization PAB 
ATCSOPAB - Session outage notify PAB 
ATCRYPAB - Definition for CRYPTO task 
ATCWUPAB - Wake up PAB 

ATCTPMPB - TPMSG PAB 

ATCTRMPEB - Termination task 

ATCPDPAB - Problem determination trace PAB. 


Operands 


None. 


Use the following syntax as an alternative to the panel interface. 
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VTCVTPAB 


Sample Output for VTICVTPAB 


VTCVTPAB 


VTCVTPAB Analysis 


Configuration Services elements 
PAB: 00017278 

+0000 86385C68 80000000 

+0010 10321000 00000010 

+0020 00000000 00000000 
level elements 
level elements 
level elements 
level elements 
level elements 
level elements 
level elements 


SOO PP WD 


Definition for Crypto Task elem 
PAB: 00C17CC8 
+0000 00000000 00000000 
+0010 60001000 00000010 


Dynamic Buffer Pool Expansion e 
PAB: 00C172E8 
+0000 00000000 00000000 
+0010 QE0C1000 00000010 


VTAM Termination Task elements 
PAB: 00C17D30 

+0000 00000000 00000000 

+0010 0D201000 00000010 


Internal Trace elements 

PAB: 00C17220 
+0000 00000000 00000000 
+0010 13201000 00000010 


LU Services Router elements 
PAB: 00C17380 

+0000 86385D40 80000000 

+0010 0F321000 00000010 

+0020 00000000 00000000 
level elements 
level elements 
level elements 
level elements 
level elements 
level elements 
level elements 


~S OO PS WD 
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065E4100 
00000000 
00000000 


anr © oo & 


— O1 


ents 


Q0C17CA4 


lements 


00C17D84 


Q0C17DAC 


00017524 


00C174DC 


00000000 


00000000 


ono oro @® © 


00000000 
00000000 
00000000 


07524DE0 
07 3BAA60 
0751FACO 


00000000 


06312010 


00000000 


00000000 


06312810 
00000000 
00000000 


06204708 
06204CA8 
073BA920 
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Network Operator Services elements 


PAB: 00C17408 
+0000 00000000 00000000 
+0010 14201000 00000010 


PD Trace elements 


PAB: 00C17B18 
+0000 00000000 00000000 
+0010 12201000 00000010 


PU Services elements 
PAB: 00C17310 
+0000 06385E18 00000000 
+0010 06321000 00000010 
+0020 00000000 00000000 
1 level elements 
2 level elements 


Session Outage Notify elements 
PAB: 00C17458 

+0000 90000000 90000000 

+0010 28201000 00000158 


Session Serialization elements 
PAB: 00C17440 

+0000 00000000 00000000 

+0010 27001000 00000140 


VARY Definition elements 
PAB: 00C172B8 
+0000 00000000 00000000 
+0010 ©B211000 00000010 


SSCP/PU Services I/0 elements 
PAB: 00C17350 

+0000 80000000 80000000 

+0010 11211000 00000010 


Timer Services elements 
PAB: 00C17248 
+0000 090000000 00000000 
+0010 0C281000 00000010 


TPMSG elements | 
PAB: 00C179C8 
+0000 80000000 80000000 
+0010 17251000 00000010 


TSC No Session elements 
PAB: 00C173C0 

+0000 00000000 

+0010 26001000 


00000000 
00000010 


Wakeup PAB elements 
PAB: 00C17908 

+0000 00000000 

+0010 29241000 


00000000 
00000010 
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00C174B4 


00C17B04 


06572F38 
00000000 
00000000 
) 
0 


00C17650 


00C1764C 


065A18D4 
00000000 


00C17750 
00000000 


00C174CC 


Q0C175A8 


00000000 


00017548 


00C1792C 
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00000000 


00000000 


00000000 
00000000 
00000000 


00000000 


00000000 


00000000 
00000000 


06316010 
00000000 


00000000 


06383810 


00000000 


00000000 


06313010 
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Use VIFNDMOD to determine the VTAM module name and displacement for a 
given address. 


VTFNDMOD is particularly useful for converting the issuer address (ISSR) in a VIT 
into a module name and displacement. It searches up to 5000 bytes before the 
specified address. 


In addition to the module name and displacement into the module that the specified 
address represents, the following is displayed: 


e Date module compiled 

PTF level, if any 

Address entered 

Module entry point address 

Address displacement into module 

First hexadecimal 40 bytes of the module 

Hexadecimal 40 bytes around the entered address 

If the address is in FLPA, MLPA, PLPA, extended PLPA, extended FLPA, or 
extended MLPA, the beginning and ending address of that region is displayed. 


eo © e@© e® 8® 8 @® 


Operands 

You must specify one address or one symbol. 

Address 
Enter 1-8 hexadecimal digits in the form X'x...' for the address used to deter- 
mine the VTAM module name and displacement. If the address is fewer than 8 
digits, it is padded on the left with zeros. 

IPCS Symbol! | 
Enter 1-31 alphanumeric characters for an IPCS symbol name that has been 
previously equated to a location within a VTAM module. Do not include a 
period. 


Under IPCS, the symbol X represents the address currently being displayed. If 
the current address points to a location within a VTAM module, X may be used 
to refer to it. 


Equated Symbols 
After the module name is determined, an IPCS symbol (the module name) is 
equated to the beginning of the CSECT. 


Symbol Description 
module eye-catcher Module entry point 


Use the following syntax as an alternative to the panel interface. 


Syntax 
>>—VTFNDMOD—- BOO BNGUOE ESS) genre etna 
— SYMBOL (symbol ) 
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Sample Output for VTFNDMOD 


VTFNDMOD ADDR(X'2B623C0') 


Module name: 
Compile date: 


Address entered: 
Module entry point: 


VTFNDMOD Analysis 


ISTORCEI 
92.262 


02B023C0 
02B022C0 


Displacement into module: 


First '40'X bytes of module: 


DATA: 02B022C0 


+0000 
+0010 
+0020 
+0030 


Storage around address entered: 


47FOFQ14 
ABF2F6F2 
BFFF4190 
C5C84160 


DATA: O2B023AC 


+0000 
+0010 
+0020 
+0030 


C54A5860 
C61CD203 
00585830 
1£035000 
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OFCSEZE3 
9OECDOOC 
AFFF4180 
C5C45060 


04085800 
6028C618 
20005030 
C7085820 


D6D9C3C5 
18CF41B0 
9FFF4170 
DO0818D6 


65701860 
58000630 
60001E06 
C7145020 
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CO40F9F2 
CFFF41A0 
8FFF50D0 
1FQ05000 


D203602C 
18204100 
8B300002 
60485020 


| .00..ISTORCEI 92 | 


VTFNDMOD 


|) w2O2 en wewee cess | 


| EH.-ED&-}. 


-0..8&. 
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Use VTMODS to find the entry point of the VTAM modules that reside in the VTAM 
private region. VTMODS reports the number of modules found and equates the 
entry point of each module found to its module name in the IPCS symbol table. 
After VTMODS executes, the VTAM modules found can be located using the 
module name in the IPCS LIST command. 


VTMODS is particularly useful when you are checking the PTF level of several 
modules or when you want to quickly verify the PTF or APAR level of a module in a 
dump. 


Note: For VTMODS to execute successfully, the VTAM private region must have 
been dumped (that is, the RGN parameter must have been specified when 
the dump was taken). If fewer than 10 modules are found, VTAM private 
storage is missing from the dump. 


If the dump does contain the VTAM private region but is a partial dump, 
VTMODS attempts to find as many VTAM modules as possible. 


Operands 

List 
The default is N. The default is N. Specify Y to receive a list of each module 
found, its entry point address, compile date, and PTF level, if present. The 
modules are in the order that they were found in storage (that is, by storage 
address, lowest to highest), followed by a list of the modules in alphanumeric 
order. 


Equated Symbols | 
For each VTAM module that is found, an IPCS symbol (the name of the module as 
it appears in the module eye-catcher) is equated to the entry point of the module. 


Symbol Description 


module eye-catcher Module entry point 


Additional Information 
The symbols created remain in the IPCS dump directory until the dump directory is 
deleted or until an IPCS DROPDUMP command is issued for the dump. 


VTMODS scans VTAM private storage for the character string IST. When IST is 
found, a check is made to determine if this occurrence of IST represents a VTAM 
module eye-catcher. Most VTAM modules have a branch instruction hexadecimal 
47FOFOxx at the entry point to the module to branch around the eye-catcher. If 
hexadecimal 47FOFOxx appears 5, 7, or 9 bytes before the module eye-catcher, the 
location is considered in most cases to be a VTAM module entry point. 


Storage is scanned starting at the lowest address of private storage to the top of 
the private region (below the 16MB line). The scan then continues starting at the 
lowest address of extended private storage (above the 16MB line) and continues 
for about hexadecimal 400000 bytes. 
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VTMODS 


Use the following syntax as an alternative to the panel interface. 


Syntax 


LIST(N) 
pews P= 
LIST(Y) 


Sample Output for VTMODS 


VTMODS LIST(Y) 


Address 


000063CA 


00006A70 
Q6006CDO 
000072E0 
0000772A 
00007768 
00009DC8 
Q000A488 
Q0000B7E8 
0000BD10 
QO00COFO 


QOQOCDAD: 


QOQOEAAS 
00011588 
000124B0 
00015C00 
Q0015ECO 
00016A18 
00016D90 
02A00138 
02A01C68 
Q@2A01EBO 
02A021B0 
02A021F8 
02A02788 
Q2A02BC8 
QO2A02ZEA8 
Q02A03100 
Q2A03E78 
02A04680 
02A082A0 
02A08968 
Q2A094E0 
O2A0EE88 
Q2A10QDA0 
02A11ECO 
02A132F0 
02A13B50 


02C31168 
02C31848 
02C31D48 
02032748 


Module 
ISTATMOQO 
ISTINCBX 
ISTINCRS 
ISTIECHS 
ISTCPMO1 
ISTSSCXY 
ISTCPCIT 
ISTINCR4 
ISTPUCWI 
ISTSSCXX 
ISTCSCEX 
ISTPDCLU 
ISTPDCSE 
ISTPUCXO 
ISTCSCSD 
ISTENQIO 
ISTENQPR 
ISTENQIN 
ISTENQRT 
ISTINMO1] 
ISTLUCQD 
ISTCPCQD 
ISTPUCQD 
ISTINCXR 
ISTSCCIT 
ISTINCCT 
ISTINCIT 
ISTINCPD 
ISTINFIC 
ISTCICPR 
ISTCICDF 
ISTINCCP 
ISTORCEI 
ISTCICTR 
ISTINCTR 
ISTINCCF 
ISTDRCIT 
ISTINCSA 


ISTXP1WB 
ISTXP1WC 
ISTXP1WR 
ISTXP1WS 
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PTF 
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Use VTNODE to determine: 
¢ Ifa SIB exists on the secondary chain where the RDTE is the SLU 


e If an RDTE application exists, and if the ACDEB, LUCB, FMCB, and FMCB 
extension associated with the session exist. 


If any SIBs exist on the secondary chain, only the first SIB is processed. To 
process the PLU, use the SES function. Excerpts of the SIB, LU RDTE, APPL 
RDTE, ACDEB, LUCB, FMCB, and FMCB extension are displayed if present. 


Operands 

RDTE Name | 
The RDTE name of a CDRSC or LU RDTE should be 1-8 alphanumeric char- 
acters. If it contains fewer than 8 characters, it is padded on the right with 
blanks. The entered RDTE name must be the SLU, and the PLU must be an 
application. For CDRSC independent LUs, VTNODE will only process the first 
entry. 


The RDTE name is required. 


NetiD 
The NetID name representing the network ID of another network outside the 
host network where a resource resides, should be 1-8 alphanumeric charac- 
ters. If it contains fewer than 8 characters, it is padded on the right with 
blanks. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


>>—VTNODE— a ace ger aaa a 
NETID(netid) 
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Sample Output for VTINODE 
VTNODE RDTE(ECHOB1B) NETID(NETB) 
VTNODE Analysis 


RDTE: O6A93DA0 
RPRNAME.. ECHOB1B RPRENTRY. 83 
RPRDEVCH. CQ6D0000 00800000 
DATA: Q6A93DAQ 
+0000 C5C3C8D6 C2F1C240 869CF568 0083070A | ECHOBIB fe5..c.. | 
+0010 00000000 00000000 00000000 O6A93E50 | ............. z.& | 
+0020 06A93E08 000A9778 OOOOAF80 00000000 | .z....p......... | 


RPRBITAN. 01000510 00 


SIB: 06C93320 
SIBFSMIN. FC SIBFSMTM. 00 SIBFSENS. 00000000 
SIBBPRIQ. O6C8F9D8 SIBBSECQ. 06C8F9D8 SIBTTMFL. 00 
SIBTSESE. 00 

DATA: 06C93320 


SIBTREAS. 00 


+0000 9800FCOO 0000000 £7F38C74 32DF4AEA | q....... X3%...¢. | 
+0010 40404040 40404040 C4E2C9D3 Cc7D4D6C4_ | DSILGMOD | 
+0020 C4E2C9D3 C7D4D6C4 A6567A2C BAE1D903 | DSILGMODw.:...R. | 


RDTE: 06954600 
RPRNAME.. ECHOC1C RPRENTRY. 55 
RPRDEVCH. CQ6DE000 00800000 

DATA: 069546D0 
+0000 C5C3C8D6 C3F1C340 
+0010 40040000 0001007A 
+0020 06954738 00000110 


RPRBITAN. 01000910 01 


00550202 
06954780 | 
o9e0c000 | . 


867A7320 
00000000 
00000110 


ACDEB: 060BD7D0 
ACDTCB... Q07F@D18 ACDCHN... 90000000 ACDRDTE.. 06954600 
DATA: 060BD7D0 


+0000 OF100000 
+0010 00000000 
+0020 20010800 


LUCB: 06306490 
+0000 52700079 
+0010 00000000 
+0020 00060000 


TSCB: 86355948 
+0000 99540000 
+0010 00000000 
+0020 81000000 


No FMCB address was 
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00000000 
00000000 
00000010 


00000000 


80000000 | 


00000000 


8636FB20 
00000003 
00000001 


062C1DA0 
00017590 
00000000 


Q62C1DA0 
0629D018 
00000000 


00000000 
00000200 
00000000 


found for the RDTE 
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00000000 
00000000 
00000000 


00000000 
01FD0000 
069546D0 


0635599C 
A6567A5C 
00000000 
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VTREADYQ 


Use VTREADYQ to analyze some of the major control blocks associated with an 
application. For each memory process schedule table (MPST) chain, the VTAM 
data extent control blocks (ACDEBs), process scheduling tables (PSTs), logical unit 
control blocks (LUCBs), and function management control blocks (FMCBs) are 
checked for PABs, DYPABs, and ready queues that contain queued elements. 
VTREADYQ lists the first elements on those queues and PABs. 


Note: For a large network, this could take several minutes to run. 


Operands 


None. 


Use the following syntax as an alternative to the panel interface. 


Syntax 
>>—VTREADYQ—————___$__$_<_—_______________ a4 


Sample Output for VTREADYQ 


VTREADYQ 

VTREADYQ Analysis 
MPST 1 
Processing begins on FMCB extension for LU TS00001 
MPST 2 . 
Processing begins on FMCB extension for LU TSO 
MPST 3 


Processing begins on FMCB extension for LU APPCAP06 
Processing begins on FMCB extension for LU APPCAPO5 
MPST 4 

Processing begins on FMCB extension for LU ISTATAQO 
There are no FMCB extensions off of LUCB 02924090 
Processing begins on FMCB extension for LU ISTPDCLU 
Synchronous TPPOSTed RPH count 1 

ELEMENT: 8295B500 


+0000 
+0010 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
+0090 
+00A0 
+00B0 
+00CO0 


01040020 
82A332A4 
00000000 
80000000 
00000000 
00000000 
00CC41F8 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


80000000 
6C000010 
0295B500 
00000000 
00000300 
00000000 
06000000 
00000000 
00000000 
00000000 
90000000 
00000000 


Synchronous normal PAB 
ELEMENT: 00CC4248 
+0000 80000000 80000000 OO0CC44CC 
+0010 O0CA81000 00000010 
Processing begins on FMCB extension for 
Processing begins on FMCB extension for 
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02915E88 
00CC49B8 
00000000 
00CC41F8 
00000000 
82A32800 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


0OCC45AC 
00000000 
02958500 
00000041 
80000000 
02A334B0 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


1 


00000000 


LU SSCPI1A 
LU VTAM 
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VTRPH 


Use VTRPH to analyze the entire LP buffer pool of request parameter headers 
(RPHs) and display those that are waiting, running, holding locks, or are in error. 


If an RPH is waiting at an address other than X'0' or X'FFFFFFFF', the major 
control block and the current process anchor block (PAB) are listed. In addition, 
the resume addresses are shown with the number of RPHs that were waiting at 


those addresses. 


Operands 


None. 


Use the following syntax as an alternative to the panel interface. 


Syntax 
>>—VTRPH 


Sample Output for VTRPH 


VTRPH 
VTRPH Analysis 
LP Buffer Analysis 
Buffers available 56 
Total number of buffers 64 
Number of expansions 0 


Buffer found does not contain an RPH at address X'02928010' 
RPH at buffer address X'02929010' is running, RPHRESUM = 0 
Module was not found 

RPH Major control block: 

DATA: OOCC48F8 


+0000 11280000 60000000 02915E88 0000000 | ........ TNsees 
+0010 00000000 0000000 0CC492C 02929010 | ......... 6...k.. 
+0020 29241000 00000010 |: -eebeubanieer 


Work elements found 4 

RPH work element address X'02A275F8' 

RPH at buffer address X'Q292B010' is running, RPHRESUM = 0 
Module was not found 

RPH Major control block: 

DATA: O0CC43F8 


+0000 11280000 60000000 02915688 e0000000 | ....... 
+0010 80000000 80000000 O0CC44B4 02928010 | ........ 6 
+0020 14201000 00000010 zoe 


Work elements found 1 
RPH work element address X'02C4F340' 


Error buffers found 1 
Unallocated buffers found 61 
Total number of buffers processed 64 


No allocated CRAs were found 
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Use VTVIT to determine which VIT options were in effect at the time of a dump, 
and whether the trace was running internally (MODE=INT), externally 
(MODE=EXT), or internally and externally. 


If the VIT was running externally, no further processing occurs. IPCS symbols are 
created for the beginning and end of the internal VIT table, and for the current, 
oldest, and last VIT entries. 


An option is available to produce an unformatted listing of the entire VIT table. Use 
VTBASIC to format the VIT table. 


To extract a VIT from a dump for use with the VIT analysis tool, use VITAL. 


Operands 

Search Argument 
Scan displays the VIT entries containing a specified search argument. Enter 
1-8 alphanumeric characters or 1-16 hexadecimal digits in the form X'x...' for 
the search argument. | 


If the hexadecimal data string is not an even number of digits, the high order 
half-byte is set to zero. | 


List VIT | 
The default is N. Specify Y to list the entire VIT table. The internal VIT table is 
processed in the following order: 


1. From the oldest trace entry to the end of the trace table 
2. From the beginning of the trace table to the current entry. 


This results in “unwrapping” the trace table so the trace entries are processed 
and listed in chronological order (that is, the oldest trace entry is listed first at 
the top of the output, and the newest trace entry is listed last at the bottom of 
the output). A message is included in-the output to indicate where the physical 
end of the trace table was encountered. 


Equated Symbols 
Symbol Description 


VIT The beginning of the VIT table 
VITC The current VIT entry 

VITO The oldest VIT entry 

VITE The end of the VIT table. 


Additional Information 

The beginning of the trace table is mapped by ITTRC in VTAM Data Areas for 
MVS/ESA. It contains the present-wrap time stamp, last-wrap time stamp, current- 
entry address, and last-entry address. The current entry is the most recent entry 
(that is, the last entry to be written before the dump was taken). The last entry is 
the one that was written in the last position of the in-storage trace table before 
wrapping to the beginning of the trace table. | 
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Use the following syntax as an alternative to the panel interface. 


Syntax 


VTVIT 


LIST(N) 
a 
SCAN (search_argument ) LIST(Y) 


Sample Output for VTVIT 


VIVIT 


VTVIT Analysis 


VTAM external trace options active at the time of this dump 


API LOCK PSS SMS PIU MSG SSCP CIO NRM APPC VCNS LCS 


VTAM internal trace options active at the time of this dump 


API PIU MSG SSCP NRM 


Pages in VTAM internal trace table (Decimal) = 


VIT 


- Start of VTAM internal trace table: 


VITC - Current VTAM internal trace table entry: 
VITO - Oldest VTAM internal trace table entry: 


VITE - End of VTAM internal trace table: 


VTAM internal trace 
VITPAGE: 0624A5A0 


+0000 
+0010 - 
+0020 
+0030 
+0040 
+0050 
+0060 
+0070 
+0080 
+0090 
+00A0 
+00B0 
+00CO 
+00D0 
+00E0 
+00FO 
+0100 


D8E4C500 
824C3110 
C5E7C9E3 
825BC9F6 
C4E2D740 
062CDB50 
D8E4C500 
81EAC990 
C5E7C9E3 
81EAC9E8 
D9C5D3E2 
824CD2A6 
E2D9C2E7 
00000000 
E2D9C2C4 
00000000 
C9D5E3E7 
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1F480110 
062CDB50 
1F000018 
80000000 
1F000110 
062CDB50 
1F4B2110 
062CDB50 
1F000050 
80000000 
1F170000 
00000000 
1F000000 
00F05500 
1F0Q0000 
00000000 
10050000 


06337250 
C1D7D9D7 
06337250 
E3E2C9D9 
06337250 
C1D7D9D7 
06337250 
C1D7E4C5 
06337250 
C1D7D9D7 
06337250 
06366010 
06337250 
00F05500 
06337250 
007F0D18 
FOC2COFO 
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50 
05F8D000 
O5F9ZEEO 
O5F92F00 
O5FBFOOO 

063372A0 | QUE. 
06366010 | b<.. 
063552D8 | EXIT 
06366010 | b$I6 
063372A0 | DSP 
06366010 | ...& 
063372CO | QUE. 
06366010 | a.I. 
063372A0 | EXIT 
06366010 | a.IY 
06366010 | RELS 
09000000 | b<Kw 
80000000 | SRBX 
824C5BD8 | .... 
80000000 | SRBD 
098e0000 | .... 
06080818 | INTX. 


table (oldest to newest entry) 


@eseeeoeeoe @#ee88 @ 
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VTVRBLK 
| VTVRBLK looks at VRs for all subareas and displays the following: 


Number of subareas supported 

Number of VRBLKs processed 

Number of subareas containing virtual routes 
Number of subareas with no virtual routes 
Number of blocked routes found 

e Number of held routes found. 


For each blocked or held route found, the status areas for each transmission pri- 
ority (TPO, TP1, and TP2) are analyzed and the following information is displayed if 
present: 


e VR number 

Adjacent subarea 

Destination subarea 

Window sizes 

Pacing limit 

Inbound and outbound sequence numbers 
Selected flags 

VR FSM 

Flow control FSM 

Count of TSCBs on VR hold queue (if any) 
Last pacing request number. 


Operands 

Subarea | 
Specify a 1-8 hexadecimal digit number in the form X'x...' or a number 
between 1- 2147483647. This represents the number of the subarea. See 
field ATCSASUP in the ATCVT for the maximum number of subareas available 
ina dump. Subarea 0 is not valid. 


lf you are not sure which subarea, if any, is having a problem, specify no 
subarea to analyze all VRs for all destination subareas. 


Report Data 
Use Detail to display further information on every VR found, similar to the infor- 
mation described above for blocked and held routes. Scan is the default and 
provides count information based on the search criteria. 


Additional Information 
See VTAM Data Areas for MVS/ESA for more information on the VRBLK and its 
contents. 


Use the following syntax as an alternative to the panel interface. 


Syntax 


SCAN 
rn 3.c: ee oe 
SUBAREA (number) DETAIL 
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Sample Output for VTVRBLK 


VTVRBLK 
VTVRBLK Analysis 
Route Blocked 
Subarea (Decimal) = 1 


VR block 00690F18 VR number 02 ADJSUBA 00000003 DESTSUBA 00000001 


Transmission priority @ VRFSM Q@5 FCFSM 00 
Window sizes: 

Current (VRBPALIM) 06 

Minimum (VRBMINWS) 02 

Maximum (VRBMAXWS) 06 

Pacing request send count 0000 

Inbound sequence number 0218 

Outbound sequence number Q20E 


Last pacing for request number 0212 
Status flags: 
VRBCWRI = @ Route change window response NOT required 


VRBRWI = 0 Route RESET window NOT required 
VRBHLD = 1 Half session held NOT required 
VRBSCNHQ = © All HSQHs have been checked for held sessions 
Host subarea skipped 2 
VRBLKs processed 32 
Subareas supported 511 
Subareas with VRs 8 
Subareas without VRs 503 
Blocked routes ] 
Held routes 0 
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Use VTWRE to count or help analyze waiting request elements (WREs). A WRE 
represents a VTAM process that is waiting for the completion of some event. A 
WRE contains a pointer to an event ID that indicates the reason for the wait state. 
WREs are queued to locked queue anchor blocks are) The LQABs to be 
looked at might be: 


e All LQABs 
e An SSCP I/O LQAB for a specific subarea 
e Another specific LQAB. 


If you invoke VTWRE without operands, the number of WREs queued to all LQABs 
are counted and the counts are displayed. 


Use the DETAIL option to get additional information on each WRE. Also, several 
operands are available to limit processing to a specific LQAB or to specific WREs. 


Operands 

Event ID 
Enter a 1-100 hexadecimal digit value to be used in matching a WRE event ID 
found in the dump. The specified event ID is left-justified when comparing with 
the contents of the dump. For example, if X'1234' is specified and the dump 
contained X'F1FOF41234', this would not be a match. 


Event ID Code 
Enter a 4 hexadecimal digit value. If the entered code is fewer than 4 digits, 
results are unpredictable. Only WREs containing this event ID code are proc- 
essed. The event ID code identifies the reason for the wait state. 


LQAB 
Enter a specific LQAB name from the following list to limit processing to a 
single LQAB. The following LQABs, which are pointed to by the ATCVT, can 
be examined. The default is ALL. 


LQAB name Description 

lIOLQB SSCP I/O LQABs (one per attached subarea) 
LUSMQ Service manager LQAB 

MCQAB Miscellaneous command LQAB 


PULQB Physical unit services LQAB 

NOSQ Network operator services LQAB 

SSLQB Miscellaneous LQAB for session services 
SSMQB Second miscellaneous LQAB for session services 
All All of the above LQABs. 


If a subarea is specified, the LQAB must be entered as IOLQB. If ALL is speci- 
fied all subareas defined to IOLQB by ATCSASUP will be processed. 
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Subarea 
Use this operand to limit processing to the SSCP I/O LQAB for a specific 
subarea. When a subarea is specified, |OLQB must be specified for the 
Queue, and Subarea is used as an index into the SSCP I/O LQABs. Specify a 
1-8 hexadecimal digit number in the form X'x...' or a number between 1- 
2147483647. This represents the number of the subarea. See field 
ATCSASUP in the ATCVT for the maximum number of subareas available in a 
dump. Subarea 0 is not valid. 


Mask 
Enter a 1-100 hexadecimal digit mask. The mask is left justified and ANDed 
with the event identifier in the dump to determine whether the specified event 
identifier was found. 


Note: Mask must be used with Event ID. 


Max 
Enter a number between 1—99999 (1—5 decimal digits or 1-4 hexadecimal 
digits) for the maximum number of WREs to be processed for the selected 
LQAB(s). The default is 100. 


Control Op Code 
Only WREs containing this CPCB op code are eligible for selection. The 
Control Op Code must be 1-8 hexadecimal digits in the form X'x...'. If the op 
code is fewer than eight digits, it is left-justified and compared with the leftmost 
digits in the dump. 


User Correlator 
Enter a 1-8 character value. Only WREs containing this User Request 
Correlator (URC) are processed. The URC is typically the resource name of 
the target of a request. 


Format 
Use Format to format the WRE and the EID, if present. With Noformat, which 
is the default, the WRE and EID are not formatted. 


Note: Do not specify Format if you use Detail for Report Data. Format is 
valid only for Scan. 


Report Data 
Scan, which is the default, counts and displays the number of WREs meeting 
the specified search criteria. Use Detail to have the following fields extracted 
and displayed from each selected WRE: 


WRE address 

Control block (RUPE) address 
CPCBOPC 

URC 

Event ID 

Event ID Code. 
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Use the following syntax as an alternative to the panel interface. 


Syntax 


p>>—VTWRE 
EID(event_id) EIDCODE (event_id_code) 


LQAB (ALL) 
ee L SUBAREA (number) — E MASK (mask) — 
MAX (100) | 
LH ed L CPK(cpcb_op_code)—| 
EC heal E sac 
URC (user_request_correlator) FORMAT DETAIL 


Sample Output for VTWRE 
VTWRE LQAB(IOLQB) DETAIL 


VTWRE Analysis 
ATCIOLQB 
WRE ADDR RUPEADDR CPCBOPC URC CODE EVENT ID 
0666D200 06648840 08810680 ECHO50Z 0201 00000001007 1000000010001020108810680 
Elements found: 1 
Elements processed: 1 
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Chapter 8. Using Traces 


This chapter describes when to use traces and shows where in the network you 
can use each trace to collect data (see Figure 33 on page 348). Examples are 
included to help you interpret trace output. 


This chapter includes the following sections: 


e “Traces Provided by VTAM” 
e “Traces Provided by NCP” on page 384. 


Traces Provided by VTAM 


The VTAM program provides several kinds of traces to record the flow of network 
events. Each trace’occurs at a different point in the network (see Figure 33 on 
page 348). This difference allows you to narrow down the problem by following a 
request/response unit (RU) through the network and determining where in the 
network the RU is incorrect. (The RU could be out of sequence or lost, the data in 
the RU could have been changed, and so forth.) 


This section includes the following information: 
e “Activating Network Traces” on page 349 
e “Formatting and Printing Trace Records” on page 361 
e “Trace Output” on page 367 
e VTAM traces and their results 


— The buffer contents trace shows the contents of inbound and outbound 
message buffers. See “Buffer Contents Trace” on page 369 for more infor- 
mation. 


— The I/O trace shows (in order) all /(O sent between VTAM and a particular 
network resource. See “I/O Trace” on page 373 for more information. 


— The SMS (buffer use) trace shows information about the use of buffers, 
including how often a buffer pool has expanded, how many buffers are cur- 
rently being used, and what was the maximum number of buffers used 
since the last trace record was written. See “SMS eel Use) Trace” on 
page 377 for more information. 


- The TGET/TPUT trace shows each message as it passes between a 
TSO command processor and TSO/VTAM. See “TGET/TPUT Trace for 
TSO/VTAM (MVS)” on page 380 for more information. 


The VTAM internal trace (VIT) is discussed in Chapter 9, “Using the VTAM Internal 
Trace (VIT)” on page 397. 


The [J VSCS trace facility is discussed in Chapter 11, “Using VSCS Service Aids 
(VM)” on page 449. 
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Display 
states 


NCP 


SEND 


PU LU 


TG Trace 
NCP PU 


RECEIVE 


CCW trace GPT, line Network 


TSO/VTAM Buffer 
TGET/TPUT contents SMS (buffer contents (operating and controller 
trace (USER) | use) trace trace (VTAM) } system) SIT trace line trace 


VIT SSCP 
——_—____—__> 


1/0 trace 
<--> 


NetView 
session trace SDLC LL2 
++—________»> + 


VIT PIU 
-—-—______——_ > 


VIT CIO 
+> 


IBMTEST 


Figure 33. Network Traces Provided by VTAM 
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Activating Network Traces 
You can activate VTAM traces when you start VITAM, using the TRACE option on 
the START command, or you can activate them when VTAM is already running, 
using the MODIFY TRACE command. Table 15 on page 350 shows the format of 
both commands for each type of trace. 


Important: 
1. The TRACE start option and its qualifiers must be coded on one line. 
2. GTF must be active to record VTAM traces externally. 


3. “VTAM” must precede each of these commands. For example, to start a 
buffer contents trace you must enter: 


VTAM MODIFY TRACE, TYPE=BUF , ID=name 


VTAM and VSCS pass all trace data to GCS, which passes the data to 
TRSOURCE, which records all system trace data. Therefore, TRSOURCE 
must be active with TYPE=GT. In addition, you must enter a GCS ETRACE 
command (with the GTRACE and GROUP operands) for the VTAM and VSCS 
virtual machine. | 


For more information see “Collecting External Trace Data (VM)” on page 359. 


4. VTAM passes all trace data except TYPE=SMS records to the VTAM trace 
file. For TYPE=SMS, SDAID must be active with TRACE VTAMBU specified. 


For more information on activating these traces and optional operands not shown in 
this table, see “TRACE for Buffer, 1/O, NCP Line, SIT, or SMS Traces” in VTAM 
Resource Definition Reference and “MODIFY TRACE Command” in VITAM Opera- 
tion. 
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Table 15 (Page 1 of 9). Activating Network Traces 


Buffer con- 
tents trace 


MVS 
p>—START procname,,,(—| Options })—————— __————__- 


Options: 


NOTRACE , TYPE=BUF | 
TRACE, TYPE=BUF—{ BUF Trace Operands 


BUF Trace Operands: 
» AMOUNT=PART IAL » IDTYPE=RESOURCE 


|—, ID=node_name 


FULL 


» AMOUNT= 
~ Lpar tia 


Notes: | 
1 Do not use NOTRACE when starting VTAM, except to override a TRACE start option coded in a 


predefined list. 
2 Code TRACE and its qualifiers on one line. Code the TYPE qualifier immediately following 
TRACE. 


>>—vm_prefix START —| Options }-—-—— A _____va 


Options: 


OTRACE, TYPE=BUF 
TRACE, TYPE=BUF—| BUF Trace Operands 


BUF Trace Operands: 
» AMOUNT=PARTIAL » IDTYPE=RESOURCE 


|—, ID=node_name 


Notes: 
1 Do not use NOTRACE when starting VTAM, except to override a TRACE start option coded in a 


predefined list. 


2 Code TRACE and its qualifiers on one line. Code the TYPE qualifier immediately following 
TRACE. 


» SCOPE=ONLY 
p>—vm_prefix MODIFY procname , TRACE—, TYPE=BUF—, ID=node_name 
» SCOPE= NLY 
ALL 


» AMOUNT=PART IAL 


oAMOUNT=——-FU LL » IDTYPE= 
PARTIAL SSC 
R 


vm_prefix 
is the prefix required for commands issued to VTAM running under VM. This prefix (usually 
VTAMWM) is determined by an operand of the GCS LOADCMD command. Use the prefix 
required by your network. 


Sawa Do not use a command prefix. 
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Table 15 (Page 2 of 9). Activating Network Traces 


CCW trace 


CNM trace 
(communi- 
cation 
network man- 
agement) 


GPT (general- 
ized PIU 
trace) 


MVS 
p>—GTF CCWTRACE 


pe—TRSOURCE TYPE 19 —— ———______—___—______—_______________». 


VSE 
p>—SDAID CCWD 


See your operating system books for more information on the CCW trace. 
Cannot be activated with the TRACE start option. 


MVS 


p>—MODIFY PROCHGNE s\RAGE VEE CORR ss tOP peers cern 
SAWBUF 


Cannot be activated with the TRACE start option. 


p>—vm_prefix MODIFY procname, TRACE—, TYPE=GPT—, ID=node_name 
» SCOPE=ONLY , IDTYPE=RESOURCE 


» ALSNAME=adjacent_link_station_name 


vm_prefix 
is the prefix required for commands issued to VTAM running under VM. This prefix (usually 


VTAM) is determined by an operand of the GCS LOADCMD command. Use the Bigre 
required by your network. 


Awa ata Do not use a command prefix. 
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Table 15 (Page 3 of 9). Activating Network Traces 


/O trace 


MVS 
>>—START procname,,,(—| Options |-) 


Options: 


OTRACE, TYPE=I 
TRACE, TYPE=I10-| I0 Trace Operands 


10 Trace Operands: 
» IDTYPE=RESOURCE 


|—, ID=node_name 


Notes: 
1 Do not use NOTRACE when starting VTAM, except to override a TRACE start option coded in a 


predefined list. 
2 Code TRACE and its qualifiers on one line. Code the TYPE qualifier immediately following 
TRACE. 


p>—vm_prefix START + Options, K-—-——A-___—__________—__»« 


Options: 


OTRACE, TYPE=I 
TRACE, TYPE=10—| 10 Trace Operands 


lO Trace Operands: 
, IDTYPE=RESOURCE 


|—., ID=node_name 


Notes: 
1 Do not use NOTRACE when starting VTAM, except to override a TRACE start option coded in a 


predefined list. 
2 Code TRACE and its qualifiers on one line. Code the TYPE qualifier immediately following 
TRACE. 


» SCOPE=ONLY 
pp>—vm_prefix MODIFY procname , TRACE—, TYPE=I0—, ID=node_name 
| » SCOPE= NLY 
ALL 


, IDTYPE=RESOURCE 


vm_prefix 
is the prefix required for commands issued to VTAM running under VM. This prefix (usually 
VTAM) is determined by an operand of the GCS LOADCMD command. Use the prefix 
required by your network. 


Masa Do not use a command prefix. 
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Table 15 (Page 4 of 9). Activating Network Traces 


Line trace 


NetView 
session trace 


MVS 
p>—START procname,,,(—| Options }})—-—___—__» 


Options: 


NOTRACE, TYPE=LINE 
TRACE, TYPE=LINE—] LINE Trace Operands 


LINE Trace Operands: 


» COUNT=ALL 
|—, 1D=Line_name 
» COUNT=——ALL 
number_of_bytes 


Notes: 
1 Do not use NOTRACE when starting VTAM, except to override a TRACE start option coded in a 
predefined list. 


2 Code TRACE and its qualifiers on one line. Code the TYPE qualifier immediately following 
TRACE. 


3 COUNT applies only to the IBM 3720 and 3745 Communication Controllers. 


>>—vm_prefix START | Options }-———————_—___—________». 


Options: 


NOTRACE, TYPE=LINE 
TRACE, TYPE=LINE—| LINE Trace Operands 


LINE Trace Operands: 


» COUNT=ALL 
t—, ID=line_name 
; aha Nei ve | 
number_of_bytes 


Notes: 
1 Do not use NOTRACE when starting VTAM, except to override a TRACE start option coded ina 
predefined list. 


2 Code TRACE and its qualifiers on one line. Code the TYPE qualifier immediately following 
TRACE. 


3 COUNT applies only to the IBM 3720 and 3745 Communication Controllers. 


» COUNT=ALL 
p>—vm_prefix MODIFY procname , TRACE—, TYPE=LINE—, ID=1ine_name 
» COUNT=—7—ALL 
number_of_bytes 


vm_prefix 
is the prefix required for commands issued to VTAM running under VM. This prefix (usually 
VTAM) is determined by an operand of the GCS LOADCMD command. Use the prefix 
required by your network. 


sae) Do not use a command prefix. 


p>—STARTCNM NLDM TRACE—————_— NN NN 


For more information on the NetView session trace, see NetView Operation. 
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Table 15 (Page 5 of 9). Activating Network Traces 


Network con- Cannot be activated with the TRACE start option. 
troller line p>—vm_prefix MODIFY procname , TRACE—,TYPE=NETCTLR—, ID=pu_name—., LINE=l ine_name-———-———————_» 
trace >—,PU=3710_pu_name 


oF sei GA 
DATA 


vm_prefix | 
is the prefix required for commands issued to VTAM running under VM. This prefix (usually 


VTAM) is determined by an operand of the GCS LOADCMD command. Use the prefix 
required by your network. 


Mea Do not use a command prefix. 
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Table 15 (Page 6 of 9). Activating Network Traces 


SIT (scanner 
interface 
trace) 


MVS 
>>—START procname,,,(—| Options |-)-—————______—_______—_—_—_—_________»>« 


Options: 


NOTRACE, TYPE=SIT 
TRACE, TYPE=SIT-] SIT Trace Operands 


SIT Trace Operands: 


» COUNT=ALL 
Fa io » TRACEPT=trace_point_id 


number_of_bytes— 


Notes: 
1 Do not use NOTRACE when starting VTAM, except to override a TRACE start option coded in a 
predefined list. 


2 Code TRACE and its qualifiers on one line. Code the TYPE qualifier immediately following 
TRACE. 


3 COUNT applies only to the IBM 3720 and 3745 Communication Controllers. 


p>—vm_prefix START — Options | 


Options: 


NOTRACE, TYPE=LINE 
TRACE, TYPE=LINE- LINE Trace Operands 


LINE Trace Operands: 


» COUNT=ALL 
|—, ID=1 ine_name 
: Se 
number_of_bytes 


Notes: 
1 Do not use NOTRACE when starting VTAM, except to override a TRACE start option coded in a 
predefined list. 


2 Code TRACE and its qualifiers on one line. Code the TYPE qualifier immediately following 
TRACE. 


3 COUNT applies only to the IBM 3720 and 3745 Communication Controllers. 


» COUNT=ALL : 
p>—vm_prefix MODIFY procname, TRACE—, TYPE=SIT—., ID=l ine_name 
»COUNT=— ALL 
number_of_bytes 


» TRACEPT=trace_point_id 


vm_prefix 
is the prefix required for commands issued to VTAM running under VM. This prefix (usually 
VTAM) is determined by an operand of the GCS LOADCMD command. Use the prefix 
required by your network. 


Ma's Do not use a command prefix. 
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Table 15 (Page 7 of 9). Activating Network Traces 


SMS (buffer 
use) trace 


TG trace 
(transmission 


group) 


TSO/VTAM 
TGET/TPUT 
trace 


MVS se 
>>—START procname,,,(—| Options -)———A 1 


Options: 
a » TY he . 
TRACE, TYPE=SMS, ID=VTAMBUF 
Notes: 


1 Do not use NOTRACE when starting VTAM, except to override a TRACE start option coded in a 
predefined list. . 


2 Code TRACE and its qualifiers on one line. Code the TYPE qualifier immediately following 
TRACE. 


pe—vmn_prefix START | Options } ——————_—____________________»~ 


Options: 
weal aids sane 
TRACE, TYPE=SMS , ID=VTAMBUF 
Notes: 


1 Do not use NOTRACE when starting VTAM, except to override a TRACE start option coded in a 
predefined list. 


2 Code TRACE and its qualifiers on one line. Code the TYPE qualifier immediately following 
TRACE. 


» [D=VTAMBUF: 
p>—vmn_prefix MODIFY ee SR 6 ce eae ed 


vm_prefix 
is the prefix required for commands issued to VTAM running under VM. This prefix (usually 
VTAM) is determined by an operand of the GCS LOADCMD command. Use the prefix 
required by your network. 


Do not use a command prefix. 
Cannot be activated with the TRACE start option. 


p>—vm_prefix MODIFY procname, TRACE—, TYPE=TG—, ID=l ine_name————_—_-___-______'-» 


vm_prefix 
is the prefix required for commands issued to VTAM running under VM. This prefix (usually 
VTAM) is determined by an operand of the GCS LOADCMD command. Use the prefix 
required by your network. 


Do not use a command prefix. 
Cannot be activated with the TRACE start option. 
MVS 


p>—MODIFY procname , TRACE—, TYPE=TSO—, ID=tso_user_id-————___________'Y——_—_ 
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Table 15 (Page 8 of 9). Activating Network Traces 


VTAM internal 
trace (VIT) 


MVS 
>>—START procname,,,(—| Options |-)—————- 


p>—vm_prefix START -+| Options }--—-————-________________________»« 


Notes: 


1. The start options are listed in this section alphabetically; however, you can code them in any 
order. 


2. Precede the option list with three commas and enclose the group of options in paren- 
theses. 


3. Start options that are entered on the START command must be separated by commas. Do 
not leave any blanks between options. 


Options: 
Selaimeahlinaillt VIT Operands sone 

NOTRACE, TYPE=VTA 
VIT Operands: 

» MODE=INT, SIZE=50 , OPTION=(API,MSG,NRM, PIU, SSCP) 

, MODE=——EXT , OPTION=——ALL: 

“Gant NONE 
,SIZE=size ption 
(option) 

Notes: 
1 NOTRACE,TYPE=VTAM is accepted but ignored. Tracing is started with the default trace table 


size and the default options. 


2 Code TRACE and its qualifiers on one line. Code the TYPE qualifier immediately following 
TRACE. 


The default options apply only to MODE=INT for MVS and VM. 
The default options apply to MODE=INT and MODE=EXT for VSE. 
The CFS trace option applies to MVS only. 

The TCP trace option applies to MVS only. 

The VCNS trace option applies to MVS and VM only. 


Nn @ a & WwW 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 a Chapter 8. Using Traces 357 


Activating Traces “Restricted Materials of IBM” 


Licensed Materials — Property of IBM 


Table 15 (Page 9 of 9). Activating Network Traces 


VIT (con- 
tinued) 


»MODE=INT,SIZE=50 


DER [nen 
INT 


pe—vm_prefix MODIFY procname, TRACE—, TYPE=VTAM- 


»SIZE=size 
» OPTION=(API,MSG,NRM, PIU, SSCP) 


» OPT ION= 


Notes: 
1 The VCNS trace option applies to MVS and VM only. 


2 These five options are defaults for MODE=INT. There are no default options for 
MODE=EXT. 


: These five options are defaults for either MODE=INT or MODE=EXT. 
4 The CFS trace option applies to MVS only. 
5 The TCP trace option applies to MVS only. 


vm_prefix : 
is the prefix required for commands issued to VTAM running under VM. This prefix (usually 
VTAM) is determined by an operand of the GCS LOADCMD command. Use the prefix 
required by your network. 


eae Do not use a command prefix. 


Starting the Generalized Trace Facility (GTF) (MVS) 

Because VTAM passes all external trace data to the generalized trace facility 
(GTF), GTF must be active to use VTAM traces. Specify TRACE=USRP to receive 
a prompt for all VTAM traces except the VTAM I/O trace. You will then be able to 
select the specific event identifier (EID) to be traced. Refer to APAR I103922 for 
additional information. | 


Note: If you do not limit the GTF trace output using the USRP option, GTF col- 
lects all USR events issued in the MVS system, often resulting in a large amount of 
unwanted information. | | 
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Figure 34. Starting the 
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Activating Traces 


S FVGTF.B 
AHL1211 TRACE OPTION INPUT INDICATED FROM MEMBER GTFPARM OF PDS 
SYS1.PARMLIB 

TRACE=SYSM, USR, TRC, DSP, PCI, SRM 

AHL1031 TRACE OPTIONS SELECTED --SYSM,USR,TRC,DSP,PCI,SRM 
*25 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U 

R 25, TRACE=USRP 

IEE6Q00I REPLY TO 25 IS;TRACE=USRP 

TRACE=USRP 
*26 AHL101A SPECIFY TRACE EVENT KEYWORDS --USR= 

R 26,USR=(FEF,FF1) 

IEE6Q001 REPLY TO 26 1S;USR=(FEF,FF1) 

USR= (FEF, FF1) 
*27 AHL102A CONTINUE TRACE DEFINITION OR REPLY END 

R 27,END 

IEE6001 REPLY TO 27 IS;END 

END 

AHL103I TRACE OPTIONS SELECTED --USR=(FEF,FF1) 

*28 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U 

R 28,U 

IEE600I REPLY TO 28 1S;U 

AHLO31I GTF INITIALIZATION COMPLETE 


VTAM Buffer Contents Trace 


Specify TRACE=RNIO for the VTAM 1/O trace. 
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Figure 35. Starting the VTAM I/O Trace 


S FVGTF.B 

AHL121I TRACE OPTION INPUT INDICATED FROM MEMBER GTFPARM OF PODS 
SYS1.PARMLIB 

TRACE=SYSM,USR, TRC,DSP, PCI, SRM 

AHL103I TRACE OPTIONS SELECTED --SYSM,USR,TRC,DSP,PCI,SRM 
*36 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U 

R 36, TRACE=RNIO 

IEE600I REPLY TO 36 IS;TRACE=RNIO 

TRACE=RNIO 

AHL103I TRACE OPTIONS SELECTED --RNIO 
*37 AHL125A RESPECIFY TRACE OPTIONS OR REPLY U 

R 37,U 

IEE6001 REPLY TO 37 IS;U 

AHLO311 GTF INITIALIZATION COMPLETE 

F NET, TRACE, TYPE=10, ID=APPL1 

ISTO97I NOCTR MODIFY ACCEPTED 

IST5131 INCTR TRACE INITIATED FOR NODE APPL1 

F NET,NOTRACE, TYPE=10, ID=APPL1 

ISTO97I NOCTR MODIFY ACCEPTED 

IST5121 INCTR TRACE TERMINATED FOR NODE = APPL1 


See Table 80 on page 1165 to determine which book contains more information on 
GTF. 


Collecting External Trace Data (VM) 

This section describes how to collect external trace output in VM. For information 
on starting and stopping the VSCS trace, see “Using the External VSCS Traces” on 
page 460. 


VM external trace data is contained in TRF files. The size of each TRF file is 
defined on the TRSAVE command. When a TRF file reaches that size, it is closed 
automatically, and another is opened. When the total number of closed TRF files 
exceeds the TRSAVE KEEP value (default is 2), CP will automatically purge the 
oldest TRF file wnen the newest one is closed. 


Important: To collect VTAM trace output in VM, issue the following commands 
from the VTAM console in the EXACT order listed here. 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


Chapter 8. Using Traces 359 


Activating Traces “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Notes: 


1. If the VTAM virtual machine has privilege class A or C, all of the following com- 
mands can be issued directly from it. If the VTAM virtual machine does not 
have the authority to issue these commands, you can issue them from any 
virtual machine having the correct authority. 


2. Unless it is defined otherwise, userid is the receiver of the TRF files. It is also 
the user ID from which the traces are processed. 


CP TRSAVE ID traceid TO userid _ traceid is the modifier referred to by subsequent 
i TRSOURCE, TRSAVE, and TRACRED com- 

mands. 

CP TRSOURCE ID traceid TYPE GT FOR VMGROUP gcsname 
gcsname is the name of the GCS group that is 
being traced. It is the NSS name that was 
IPL-ed. To determine the GCS group name, 
issue QUERY GROUP from the VTAM virtual 
machine. 

CP TRSOURCE ENABLE ID traceid 

ETRACE GTRACE GROUP 

VTAM F TRACE, TYPE=type.... 


VTAM starts external tracing. When you have collected enough data, and you want 
to stop tracing, issue the following commands: 


ETRACE GTRACE OFF GROUP You must specify GROUP. 
CP TRSOURCE DISABLE ID traceid 
VTAM F NOTRACE, TYPE=fype,... 


At this point, the user ID specified on the TRSAVE command has all the TRF files 
of the name traceid specified in the TRSOURCE and TRSAVE commands. To 
process these TRF files, logon to the user ID. 


Use the CP QUERY TRFILES command to determine whether TRF files were 
produced, the number and size of the files, and the user ID that produced them. 


VTAM records trace entries in every virtual machine in the GCS group that contains 
a VTAM application, not only in the VTAM virtual machine. Also, a small number of 
trace entries are recorded in the GCS recovery machine. Consequently, it is 
normal to have TRF files from multiple virtual machines. If an application virtual 
machine's user ID is not listed under the ORIGINID header on the CP QUERY 
TRFILES command, then that user ID did not record trace entries. 


See “Formatting and Printing Trace Records” on page 361. To determine what 
book contains information on using TRSAVE and TRSOURCE, see Table 80 on 
page 1165 


Virtual Machine Tracing (VM) 
The PER command does not apply to VM. The equivalent command is CP 
TRACE; however, you can specify PER as an alias for the TRACE command. 


See Table 80 on page 1165 to determine what book contains more information on 
the CP TRACE command. 
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Formatting and Printing Trace Records 


Table 16 indicates which traces can be formatted and printed by each of the for- 
matting programs.’ Descriptions of the programs appear later in the chapter. In this 
table: | 


e FP indicates that the trace is both formatted and printed (for VTAM records 
only) 


e UP indicates that the trace is printed but not formatted. 


e A blank entry indicates that the trace is neither formatted nor printed. 


Table 16. Processing Externally Recorded Trace Data 
IPCS TRACERED TPRINT DOSVSDMP 


Trace ACF/TAP 
Buffercontents trace  §# #§ FP = FP FP FR 
Generalized PIU trace FP 

/O trace FP FP FP FP 

Line traces FP EPs FP4 FP4 

Network controller line trace FP FP4 FP4 FP4 

Scanner interface trace FP 

SMS (buffer use) trace UP FP FP FP 
TGET/TPUT trace UP UP 

Transmission group trace FP FP4 FP4 FP4 

VSCS internal trace FP 

VTAM internal trace® UP FP FP FP 


Using ACF/TAP 

Use the trace analysis program (ACF/TAP) to print all VTAM external trace entries 
or up to ten entry types. Table 17 lists the options to use on the INPUT operand 
for formatting and printing traces. See Table 80 on page 1165 to determine what 
book describes ACF/TAP. 


Table 17 (Page 1 of 2). ACF/TAP Options 


Specify: To format and print: 

LINE Line trace 

LINE Scanner interface trace (8720, 3725, and 3745 only) 
LINE Transmission group trace 

GPT Generalized PIU trace 


RNIO I/O trace 


3 This is not a complete list of programs that process external trace data. 

4 Only scanner type 1, 2, and 3 records are processed. All others must be processed using ACF/TAP. 

5 ACF/TAP must be used except for 3705 traces. See “Line Trace Operation” on page 386 for more information. 
6 ACF/TAP allows you to specify some formatting parameters if the VIT is running in external mode. 
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Table 17 (Page 2 of 2). ACF/TAP Options 


Specify: To format and print: 
BUFFER Buffer contents trace 
NETCTLR Network controller line trace 


Notes on using ACF/TAP: 


1. The system services program (SSP) V3R8 must be installed before you can 
use ACF/TAP to format the VTAM full buffer contents trace. 


2. ACF/TAP does not print a buffer contents trace that is traced at the API. Use 
IPCS GTFTRACE to print API (FF1) traces. 


3. Do not use ACF/TAP to print VSCS trace output. 


Using IPCS with GTF Trace Option (MVS) 

To format and print the VTAM I/O trace, set RNIO on the GTFTRACE option. For 
all other VTAM traces, set USR(symnum1[,symnum2]...{symnum6]/ ALL) on the 
GTFTRACE option. 


symnum can be either a symbolic name or a number representing the trace that 
you want formatted and printed. If you specify USR(ALL), IPCS formats and prints 


all user and subsystem traces recorded by GTF. For information on starting GTF, 
see “Starting the Generalized Trace Facility (GTF) (MVS)” on page 358. 


Table 18 lists the valid symbols and numbers for the VTAM traces. 


Table 18. Symbols and Numbers for Formatting and Printing VTAM Traces 


Symbol Number Trace — 
INT1 FE1 VTAM internal trace 
TPIO FEF VTAM buffer contents trace (TSC component) 
Trace output says “VTAM..” 
CLO1 FF1 VTAM buffer contents trace (API component) 
Trace output says “USER..” 
CLO2 FFO SMS (buffer use) trace 
LINE FF2 NCP 37xx line or TG trace 
APTH FE2 TSO/VTAM TGET/TPUT trace 
APTD FE4 Line PIU, generalized PIU, or network controller line trace 


Note: The symbol and the number can be used interchangeably, for example, USR(LINE) 
or USR(FF2); however, when starting GTF, use the number. 


See Table 80 on page 1165 to determine what book describes how to use GTF 
and IPCS. 
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Using TRACERED (VM) 
You can format and print trace output using TRACERED with the following com- 
mands: 


ACCESS 193 x Link to the minidisk that contains the GCS and 
VTAM formatting routines, usually 193. xis a 
user-specified file mode. 


TRACERED NAME traceid (ALL traceid is the collection of TRF files and is the 
same value as is specified in the TRSAVE and 
TRSOURCE commands. traceid will cause 
TRACERED to process all of the TRF files at 
once, producing a consolidated output file in 
chronological order. 


See Table 80 on page 1165 to determine which book contains more information on 
TRACERED. 


Using TPRINT (VSE) 
Trace records in the external trace file can be printed, formatted or unformatted, by 
using the TPRINT utility program. 


The trace print utility runs as a subtask under VTAM or as a job step under VSE. 
To run the trace print utility as a subtask, the operator initiates printing with the 
MODIFY SUBTASK command while VTAM is active. When the utility is run as a 
separate job step, printing can be done whether VTAM is active or inactive. 


If TPRINT runs as a subtask, it is executed in the same address space in which 
VTAM runs and must be started in a static partition. VTAM JOB has the JCL for 
TPRINT. If TPRINT runs as a separate job, it can run in either a static or a 
dynamic partition, and SYS001 and SYS004 must be defined in the job, as shown 
in “Running TPRINT in a Separate Partition” on page 364. 


Note: VTAM phases, macroinstructions, modules, and user-defined VTAM defi- 
nitions reside in a group of sublibraries (library.sublibraries), which the system 
searches from left to right when loading is required. In the following examples, the 
system searches the user definition library and the VTAM library. Each of these 
sublibraries contains phases, macroinstructions, and modules. The system subli- 
brary default is IISSYSRS.SYSLIB, and it is searched last (by default). 


Job Step Procedure: The trace print utility can be executed through a job step 
procedure that is defined when VTAM is installed. SYSLST is assigned to a tape, 
printer, or disk, and the trace file is defined in DLBL and EXTENT statements. For 
example: 

// LIBDEF *,SEARCH=(PRD2.CONFIG, PRD1.BASE) 1 

// DLBL TRFILE,'VTAM.TRACE.FILE' 

// EXTENT SYSQ04 

// ASSGN SYS004,cua 

// ASSGN SYSLST,cua 


// EXEC TPRINT 
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SYSLST must be assigned to a printer, tape, or disk with the name IJSYSLS. If it 
is not assigned, TPRINT is canceled. 


Running TPRINT in a Separate Partition: When TPRINT runs in a partition sep- 
arate from VTAM, SYS001 and SYS004 must be defined for the partition in which 
TPRINT runs. The following is sample JCL defining SYSO001 and SYS004 for the 
partition in which TPRINT runs. (In this sample, cua is the channel unit address for 
the device.) 


// JOB TPRINT 

// LIBDEF *,SEARCH=(PRD2.CONFIG,PRD1.BASE) 1 
// DLBL TRFILE,'VTAM.TRACE.FILE' 

// EXTENT SYS00Q1 

// ASSGN SYS0Q01,cua 

// ASSGN SYS004,cua 

// ASSGN SYSLST,cua 

// EXEC TPRINT 

/& 


MODIFY SUBTASK Command: To start the trace print facility with the MODIFY 

-SUBTASK command, use the ID=TPRINT option. The operator is prompted to 
request a print of the TRFILE, using any of the print options available or a snapshot 
print. A snapshot prints all the /O, BUF, LINE, and TNSTAT records in VTAM's 
main storage I/O buffers, without accessing records previously written to TRFILE. 
When the contents of TRFILE are being printed, all tracing is suspended until the 
printout is completed. 


Note: When the trace print facility is run as a subtask, the trace output is not 
printed by VSE until VTAM is halted. 


For more detailed information about initiating the trace print facility and the options 
available, see “Attaching the Trace Print Program as a VTAM Subtask (VSE)” in 
VTAM Operation. 


All trace records contain either a time stamp or a formatted time and date field from 
which the order of recording can be determined. This information can be helpful in 
synchronizing buffer contents and I/O traces and, to a lesser extent, VTAM and 
non-VTAM traces. 


The TPRINT User Exit Facility: An interface is provided in the trace print facility 
to allow the user to write an exit routine for the editing of VTAM trace records. The 
dummy user exit module, ISTRAEUE, can be replaced by an installation-supplied 
module. The dummy module is called by the trace writing module, ISTRACTO, 
with the following register contents: 


Register Contents 
0 0 = first entry to module 
1 = return for more output 
1 Address of parameter list 
13 Save area address 
14 Caller's return address 
15 ISTRAEUE entry point address 


The parameter list pointed to by register 1 contains the following information: 
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e Word 1: Address of trace record (ISTTRAB) 
e Word 2: Address of output buffer 
e Word 3: Address of date and time stamp for this record. 


Consider the following points when programming a user exit routine for the TPRINT 
facility: 

e TPRINT provides support for reading TRFILE with VSE access methods 
DTFSD or DTFMT. The file format is standard variable blocked records with 
BLKSIZE=2048. Each physical record contains a dummy 16-byte logical record 
that provides control information for TPRINT and is not passed to the user exit 
routine. The block header and the dummy record are mapped by the TRB. 


e The remaining logical records contain trace data. Each has a 32-byte header 
mapped by the TRAB. Each is passed to the user exit routine for processing. 
Contents of the TRAB header and data format and length vary according to the 
trace record type. 


e TPRINT provides access method support for all SYSLST output. Line counting 
and page headers are provided automatically. DTFDI! is used with ASA control 
characters. The output buffer is cleared to blanks before the user exit routine 
is called. Use of control characters is limited to the following: 


— Single space ( ) 

— Double space (0) 

— Triple space (-) 

— Skip to channel 1 (1). 


If a skip is specified, TPRINT inserts its own page header and double spaces 
before printing the specified line. 


e The TPRINT user exit routine can provide its own access-method interface to 
SYSLOG (console) or any other device. For example, you can require 
operator-specified, record-selection options to produce specific portions of trace 
records, such as line trace records or VIT entries. 


¢ Buffer, I/O, and TNSTAT records are single entry data records. Line and 
internal trace records contain one or more entries following the TRAB header. 
The user exit routine must perform all de-blocking logic for multiple-entry 
records, using return code 8 to request re-entry from TPRINT for additional 
processing of the same trace record. See Figure 36 on page 366 for an 
example of user exit routine logic. 
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Figure 36. TPRINT User Exit Routine Logic 


Using DOSVSDMP 
See Table 80 on page 1165 to determine what book describes DOSVSDMP. 
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Trace Output 


| Trace Output 


In addition to the fields produced by VTAM, Table 19 contains generic fields that 
might appear in VTAM trace output. 


Table 19. Fields in VTAM Trace Output 


Field Header 


ASCB nnnnnnnn 


CPU nnnn 


JOBN cccccccc 


RNIO 


USRxx nnn 


The address of the ASCB for the address space that created the 
record. 


The ID of the host processor in which the trace was run (applies only 
in a multiprocessor configuration). 


The name of the job associated with the I/O operation (for an I/O 
trace). 


The trace record was created by GTF (with TRACE=RNIO). 


The formatting routine (AMDUSRxx). VTAM's trace formatter is 
AMDUSRFD. nnn is the event ID that represents this trace. 


In addition to the fields produced by VTAM, Table 20 contains VM-only fields that 
might appear in VTAM trace output. 


Table 20. Fields in VTAM Trace Output 


Field Header 


Time-of-day clock 


Length of trace 
header and trace 
data 


Format routine ID 


Event 
identification 


Time when trace record was created. To determine what book 
describes how to interpret time-of-day clock entries, see Table 80 on 
page 1165. 


Indicates the length of this trace record. 


Identifies formatting module used for this record. 


Identifies the event being traced. ID parameter: 


EFAA VSCS trace entry 

EFEF Buffer trace entry (VTAM) 

EFE1 VTAM internal trace entry 

EFE4 Line PIU, generalized PIU, or network controller 
line trace entry 

EFFO — SMS trace entry 

EFF1 Buffer trace entry (user) 

EFF2 NCP 3705 line, TG trace, or scanner interface 
trace entry 

E100 RNIO inbound I/O trace entry 

E200 RNIO outbound I/O trace entry 


See Figure 37 on page 368 and Figure 38 on page 369 for the format of VTAM 


trace records. 
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BUF (USER) BUF (VTAM) 


Hex 0 
nue | sed 
4 


Flags/ILRC |OLRC 


8 

10 

18 
Destination 
name 


P ——»20 
Origin NETID 
28 
Destination 
NETID 


1 te 
Les 


LINE (CS 2) LINE (CS 3) 


RLEN 0000 
TOD clock 


Line name 


Hex 0 


4 
8 

TOD clock 
10 


saat . 
Perio 


9-byte 24 9-byte 
RU header RU header 
- 28 
Variable Ls ; 
number of . 
4-byte ; ‘ One or more data 
entries , ; entries, first 
‘ ‘ byte of: 
O=text data 


x=status info 


Legend 

RLEN = Total record length 

SEQ = Sequence number when running Full Buffer Trace 
OFS = Offset of the Network qualifiers (if present) or zero 
Flag bit 0 (direction): 1 = Inbound 

Flag bit 1: 1 = Confidential text 

Flag bit 2: '10'B = First segment of full buffer trace record 
Flag bit 3: '01'B = Last segment of full buffer trace record 
ILRC = Inbound lost record count 

OLRC = Outbound lost record count 


Figure 37. VTAM Trace Record Format 
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10 
Hex 0 
0044 0000 
4 
1 |Fiags ILRC} OLRC 


8 
C TOD clock 
10 
Origin name 
14 
18 
Destination 
name 
20 


Tuning statistics 
(TNSTAT) 


Hex 0 
= 0000 
000000 


Time and 
date stamp 
10 


18 


> 


(ee) 


2 
2 4-byte 
data 
fields 
of 
Legend 


RLEN = Total record length 


Flag bit O (direction): 1 = Inbound 

Flag bit 1: 1 = Confidential text 

Flag bit 2: '10'B = First segment of full buffer trace record 
Flag bit 3: ‘'01'B = Last segment of full buffer trace record 
ILRC = Inbound lost record count 

OLRC = Outbound lost record count 


Figure 38. VSE-Unique Trace Record Formats 


Buffer Contents Trace 


Buffer Contents Trace 


9-byte 
RU header 


Variable 
number of 
4-byte 
entries 


The buffer contents trace shows the contents of message buffers in two places: the 
application program interface (API) and the transmission subsystem component 
(TSC). When data is sent by an application program (outbound), API is the first 
component of VTAM to process it, and TSC is the last component of VTAM to 
process it. When data is received from the network (inbound), TSC is the first com- 
ponent of VTAM to process it, and API is the last. To enable you to distinguish 
where in VTAM the trace data was recorded, the output specifies: 
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e Either USER (for data recorded in API) or VTAM (for data recorded in TSC). 


e If the recorded data is inbound or outbound. 


The API writes user buffer contents trace records while user data is still in the 
application program's buffers, before it is copied into VTAM buffers. Only user data 
is recorded. | 


TSC writes VTAM buffer contents trace records while the data is in VTAM fixed I/O 
buffers. The PIU — that is, the transmission header (TH), request/response header 
(RH), and user data — is recorded. 


For a list of the resources for which you may request a buffer contents trace see 
“Resource and Trace Reference” in VTAM Operation. 


You may request a partial buffer contents trace or a full buffer contents trace. For 
a partial buffer contents trace, VTAM writes trace records with a maximum size of 
256 bytes. The partial buffer contents trace is the default. 


For a full buffer contents trace, VTAM records all of the data transmitted in 
message buffers. The full buffer trace record has a maximum length of 8K bytes 
(fa 2K bytes) including trace field headers, transmission headers, 
request/response headers, and data. If storage is not available to record a trace 
record in an 8K block ( {9 2K block) , VTAM will record the trace record in 
256-byte blocks until the complete trace record is recorded. 


Notes: 


1. VTAM can start a buffer contents trace only for the resources that it owns. A 
data host, which does not own any NCPs, cannot start a buffer contents trace 
for an NCP or any of the NCP's subordinate resources. 


2. If you want to trace a session between an LU and an application program, you 
must start the trace at the host where the application program resides. 


3. If the buffer contents trace is active for a specific APPC application, the FMH5 
is always traced at the user (API) level. 


When to Use the Buffer Contents Trace | 
The buffer contents trace can help you determine whether a problem is in the host 
(VTAM or an application program) or in the network. For example, if an application 
program sends a message to a terminal, and the message is correct in VTAM 
buffer contents trace output, but the message does not appear correctly at the ter- 
minal, then the problem is probably in a system resource other than VTAM or the 
application program. 


The buffer contents trace cannot always be used to distinguish an application 
program problem from a VTAM problem. However, it can confirm the order in 
which data is passed between an application program and a logical unit. It can 
also record all the data passing to and from an application program. 


Partial buffer contents tracing is the default. Because of the possible effect on 
storage and performance, use the full buffer trace only when you need complete 
buffer data for problem determination. The full buffer contents trace may increase 
storage use because of the larger size of trace records and the possible need to 


370  VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” Buffer Contents Trace 
Licensed Materials — Property of IBM 


increase the size of the trace data set. Performance may be degraded because of 
the additional time needed to write the complete buffer trace records. 


If you do not need to trace user data, use the I/O trace. 


Buffer Contents Trace Operation 

Make sure that GTF with the TRACE=USR option is active before starting this 
trace. See “Starting the Generalized Trace Facility (GTF) (MVS)” on page 358. 
Ri] VM V1R2.2 or higher is required to use the buffer contents trace. 


Start the buffer contents trace with the MODIFY TRACE command or the TRACE 


start option. 

Specify: To Trace: 

ID=nodename Requests and responses flowing between VTAM and nodename. 
ID=VTAM Request and response units (RUs) for SSCP sessions. 
ID=ISTPUS Request and response units (RUs) for sessions between the host 


physical unit and another physical unit type 4 or 5 (these RUs 
include ER-ACT, ER-OP, and ER-TEST RUs). 


If you use the SCOPE=ALL or EVERY operand when you start the trace, VTAM 
records messages to and from the specified node and all its valid subnodes. 


Note: You cannot use the SCOPE=ALL or EVERY operands with ID=ISTPUS. 


For more information on the MODIFY TRACE command, see “MODIFY TRACE 
Command” in VTAM Operation. For more information on the TRACE start option, 
see “TRACE for Buffer, I/O, NCP Line, SIT, or SMS Traces” in the VTAM Resource 
Definition Reference. 


ES To format and print buffer contents trace output, use ACF/TAP or IPCS. 


Ri] To collect buffer contents trace information, use the TRSOURCE command. 
To format and print buffer contents trace output, use TRACERED or ACF/TAP. 


To print buffer contents trace output, use TPRINT or ACF/TAP. 


For more information, see “Formatting and Printing Trace Records” on page 361. 


Buffer Contents Trace Output 

Figure 39 shows an example of partial buffer contents trace output. 

Figure 40 on page 372 shows an example of full buffer contents trace 
output. Output is very similar to the examples shown. 


BUFF APPL12 /TERM2@0 LRC(000,000) = INBOUND 
VTAM TH=40000000 200000C2 0000 O0OC 00000004 I1C000005 0028004 0040 RH=030080 


7DD8E811 D7F1F3C8 C1E3C140 C9E240C3 *'QY.PITHIS DATA IS Cx 
D6D4D4C9 D5C740C9 D540D6D5 40E4E2C5 *OMING IN ON THE USE * 
BUFF TERM200 /APPL12 LRC(000,000) OUTBOUND 
USER C5D5E3D9 40C4C1E3 C140E3D6 40C5C8D6 *ENTER DATA TO ECHO Bx 
C5D3D6E6 4B5CFO4B D7D9C5E2 E240C5D5 *ELOW.*@.PRESS ENTER * 


Figure 39. Example of Partial Buffer Contents Trace Output 
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USRFD FEF ASCB Q0EBD380 JOBN ECHO42A 
BUFF NETA.APPL1 /NETA.APPL2 LRC (000, 000) INBOUND COMPLETE SEGMENT 
VTAM TH=40000000 00000000 00000001 00000001 1(€000014 001B08A7 0003 RH=838000 
GMT-11/02/93 17:32:48.795383 LOC-11/02/93 13:32:48.701175 . 


USRFD FEF ASCB 0@EBD380 JOBN ECHO42A 
BUFF NETA.APPL1 /NETA.APPL2 LRC (000,000) INBOUND FIRST SEGMENT S$EQ(00@1) 
VTAM TH=40000000 00000000 00000001 00000001 1(000014 001B08A7 232B RH=0380C0 
C1D7D7D3 F1404040 @000D5C5 E3C14040 40400000 *APPL1 ..NETA .o% 


40D9C5C1 C4E840C6 D6D940C6 C9D9EZE3 40C9D5D7 * READY FOR FIRST INPx 
E4E34B40 D3D6C7D6 D540C4C1 E3C1407E 40E2C9D4 +*UT. LOGON DATA = SIM* 


D3D6C7D6 D5150000 00000000 O0000000 O0000000 *LOGON............... * 
00000000 00000000 COQQ0OLO OHOOHO0O OOOOOOOO *...........ceceeeeee * 
00000000 00000000 GO00000O OOOO00GO OOODQO0O *........... cece eae * 
00000000 00000000 D0QH0NEOO BOOCOOOO GODOOOOO +*......... cc ceweeeeee * 
00000000 00000000 00000000 OHO0OO0O QODOO0GO +*.................... * 
00000000 00000000 000000 Hevcvecccces * 
GMT-11/02/93 17:32:48.802207 LOC-11/02/93 13:32:48.707999 
USRFD FEF ASCB Q0EBD380 JOBN ECHO42A 
BUFF NETA.APPL1 /NETA.APPL2 LRC (000 ,000) INBOUND LAST SEGMENT SEQ(002) 
VTAM 00000008 00000000 DOGOOOOO OOODH00O QOOGO0OO *......... cece eceoeee * 
00000000 90000000 00000000 DHOH0QOO BOOOHOOO *.......... ce eee ewes * 
Q00000EG 0LQO000O OEGOOEOO OOOOOHOOO OOOGOOOO *..............eeeeee * 
00000008 00000000 00OO0GO0 OOOOOO0O HOOOODOO *.............ceeoeee * 
00000000 00000000 OOQOOEOO HOHOQO00O OOOOOOOO *............cceeneee * 
00000000 00OO000O OLQOOOOO OOORH0OO OODOOOOO *........... cece eee ue® 
00000000 00000000 H00Q0000 BOQO0O0O OOOODHOO *.......... cece eens * 
00000000 00000000 O0EOO000 OOOOQO0O OOOOGO0O *.................0.- * 
00000000 00000000 NDEOOGOO HOOOOOOO OODOOOOO *........... cee eneee * 
00000008 00000000 00 eee ee * 


GMT-11/02/93 17:32:48.802423  LOC-11/02/93 13:32:48.708215 
Figure 40. Example of Full Buffer Contents Trace Output 


Table 21 explains the trace fields. In addition to these fields, operating-system- 
dependent fields may appear. For a description of these fields, see Table 19 on 
page 367 and Table 20 on page 367. 


Table 21 (Page 1 of 2). Fields in the Buffer Contents Trace 
Field Header Meaning 


BUFF destname/origname Is the destination (destname) and origin (origname) node 
name. In Figure 39 on page 371 the destination is 
APPL12 and the origin is TERM200. 


LRC(Qox, yyy) The number of records lost since the last trace record 
was written because the trace facility could not get a 
VTAM buffer. xxx is the destination's lost record count, 
and yyy is the source's lost record count. 


INBOUND or OUTBOUND The direction of the traced data (inbound or outbound) 
with respect to this host subarea. By use of this field 
and the PIU sequence number in the TH, requests and 
corresponding responses can be matched. 


position SEGMENT Indicates whether this trace record is FIRST, MIDDLE, or 

(full buffer trace only) LAST in a series of trace records generated for one 
trace invocation. If only one trace record is needed, the 
value is COMPLETE. The segment indicator field 
appears only when full buffer contents tracing is in effect. 
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Table 21 (Page 2 of 2). Fields in the Buffer Contents Trace 


Field Header 


SEQ(xxx) 
(full buffer trace only) 


VTAM or USER 


TH 


RH 


Meaning 


A sequence number indicating the sequence in which 
trace records were generated. The sequence number 
appears only when a series of trace records is generated 
for a single trace invocation. The sequence number 
does not appear when one trace record shows a com- 
plete buffer. The sequence number starts at 1, and 
upon reaching 255, wraps to 0. A gap in sequence 
numbers could indicate lost trace records. The 
sequence number field applies only when full buffer con- 
tents tracing is in effect. 


Indicates where the message buffers were traced. 
VTAM means the buffers were traced in TSC (in which 
case the TH and the RH are included in the trace 
record). USER means the buffers were traced in API (in 
which case the TH and the RH are not included). 


The transmission header portion of the path information 
unit (PIU). 


The request/response header portion of the PIU. 


Note: The rest of the trace record shows the contents of the buffer as displayed in 


Figure 39 on page 371. 


Notes: 


1. If the buffer trace information is out of sequence your trace may have wrapped. 
2. User entries are not printed by ACF/TAP. 


3. Confidential data is not recorded in trace records. When the trace facility 
detects confidential data (CONFTXT=YES is specified on the application pro- 
gram's NIB macroinstruction), the user data is replaced with the marker in the 


trace output. 


The marker is “CONFIDENTIAL AND SUPPRESSED.” 
The marker is “CONFIDENTIAL DATA.” 


If you are using the VTAM encryption facility, data on a cryptographic 
session is handled in the same way as confidential data. 


/O Trace 


The I/O trace shows requests and responses that flow between VTAM and network 
nodes. You can trace I/O activity for any of the following types of nodes: 


e Application program 


e Physical unit 
e Logical unit 


e SNA cluster controller 


e NCP 
e SSCP 


e Host physical unit 


e Host as an intermediate routing node 
e Channel attachment major node 


e Cross-domain resource 
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e Cross-domain resource manager. 
The maximum I/O trace record length is 36 bytes. 


Note: If you want to trace a session between an LU and an application program, 
you must start the trace at the host where the application program resides. 


When to Use the I/O Trace 

Use the I/O trace to record the order that PIUs flow between network nodes and 

VTAM. For example, you might use this trace to determine whether an application 
_ program receives all the responses that it should and whether VTAM forwards all 

the requests issued by the application program. 


lf you are using the AnyNet” SNA over TCP/IP program product, the I/O trace 
provides tracing of all MPTN formats that are sent to and received from the TCP/IP 
network. See “AnyNet I/O Trace Format for SNA over TCP/IP (MVS)” on page 376 
and VTAM AnyNet Feature for V4R2: Guide to SNA over TCP/IP for additional 
information. | 


The content of the I/O trace is similar to that of the buffer trace, except that the I/O 
trace collects less user data. If you do not need this user data, you can save trace 
file space by using the I/O trace. 


I/O Trace Operation 

Before starting the I/O trace, make sure that GTF with the TRACE=RNIO 
option is active. See “Starting the Generalized Trace Facility (GTF) (MVS)” on 
page 358. 


Start the I/O trace with the MODIFY TRACE command or the TRACE start option. 


Specify: To Trace: 

ID=nodename Requests and responses flowing between VTAM and nodename. 
ID=VTAM Request and response units (RUs) for SSCP sessions. 
ID=ISTPUS Request and response units (RUs) for sessions between the host 


physical unit and another physical unit type 4 or 5 (these RUs 
include ER-ACT, ER-OP, and ER-TEST RUs). 


ID=ISTIRN Request and response units (RUs) that flow through this host while 
this host is acting as an intermediate routing node. 


Note: 


1. If you use the SCOPE=ALL or EVERY operand when you start the trace, the trace con- 
tains |/O activity for the specified node and all its valid subnodes. You must specify 
SCOPE=ALL when tracing a channel-attachment major node or when tracing an APPN 
PU. You cannot use the SCOPE=ALL or EVERY operands with ID=ISTPUS or 
ID=ISTIRN. 

2. You may trace a link in a channel-attachment major node, but not a link station. 


See “MODIFY TRACE Command” in VTAM Operation for information on the 
MODIFY command. See “TRACE for Buffer, 1/O, NCP Line, SIT, or SMS Traces” 
in the VITAM Resource Definition Reference for more information on the TRACE 
Start option. 
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If you are using the AnyNet SNA over TCP/IP program product, refer to the 
section on diagnosing SNA over TCP/IP problems in VTAM AnyNet Feature for 
V4R2: Guide to SNA over TCP/IP for information about activating the I/O trace. 


To format and print I/O trace output, use ACF/TAP or IPCS. 


To collect I/O trace information, use the TRSOURCE command. To format 
and print I/O trace output, use TRACERED or ACF/TAP. 


To print I/O trace records, use TPRINT or ACF/TAP. 


For more information, see “Formatting and Printing Trace Records” on page 361. 


//O Trace Output (MVS) (VM) 


Figure 41 shows an example of !/O trace output. 


The trace fields are explained after the figure. In addition to the fields described 
here, additional operating system-dependent fields may appear. For a description 
of these fields, see Table 19 on page 367 and Table 20 on page 367. 


OUT..... 40000000 00000000 00000001 00000001 1D000092 0015001B 00256B80 00310102 02714020 
GMT-11/02/xx 18:50:31.827470 LOC-11/02/xx 14:50:31.733262 


INeseess 40000000 00000000 00000001 Q0000001 10000015 0092001B O004EB80 0031 
GMT-11/02/xx 18:50:31.830107 LOC-11/02/xx 14:50:31.735899 


Figure 41. Example of I/O Trace Output 


The following fields appear in the I/O trace: 


Field Header Meaning 


OUT or IN The direction of the data shown in the trace record: OUT for out- 
bound to the specified node and IN for inbound to VTAM. When 
ISTIRN is specified, each RU is traced twice — once when it leaves 
VTAM (OUT) and once when it enters VTAM (IN). 


The rest of the trace record is some or all of the path information unit (PIU). It 
consists of a 26-byte transmission header (TH), a request/response header (RH), 
and as much of the request/response unit (RU) as will fit. The data length field in 
the TH indicates the length of the RH and RU in bytes. The RU may contain sense 
data. 


/O Trace Output (VSE) 
Figure 42 shows an example of I/O trace output for VSE. The trace fields are 
explained after the figure. 


IO TERM12 / 87 .153/10:31:02.13 OUTBOUND 
TH=40060000000600000000600C0006800C1D0060390005800D0028 RH=6B8000 RU=31010202714020 


10 /TERM12 87.153/10:31:62.15 INBOUND 
TH=486000800080068060000000CE00G000C1D00000500396800D0004 RH=EB8000 RU=31 


Figure 42. Example of I/O Trace Output 


The following fields appear in the I/O trace: 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Chapter 8. Using Traces 9375 


/O Trace 


Field Header 


lO destname/origname 


yy.jj//nh:mm:ss.hh 


LRC(xxx, yyy) 


INBOUND or OUTBOUND 


TH 


RH 
RU 
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Meaning 


Is the destination (destname) or origin (origname) node 
name. Usually, only one node name is resolved by the 
I/O trace. In Figure 42, the node name is TERM 12 in 
both records. 


Is the year (yy), the Julian date (jjj), and the time in hun- 
dredths of a second (hh:mm:ss.hh) that the trace record 
was written. 


This field is “87.153/10:31:02.13” in the first trace record 
in Figure 42. 


Is the number of records lost since the last trace record 
was written because the trace facility could not obtain 
VTAM buffers. xxx is the destination’s lost record count, 
and yyy is the source's lost record count. 


Note: This field is not present in the trace record unless 
records are lost. 


The direction of the traced data (inbound or outbound) 
with respect to this host subarea. With this field and the 
PIU sequence number in the TH, requests and corre- 
sponding responses can be matched. 


Is the 26-byte transmission header portion of the path 
information unit (PIU). The data length field in the TH 
indicates the length of the RH and RU in bytes. 


Is the 3-byte request/response header portion of the PIU. 


Up to ten bytes of the request/response unit, which may 
contain sense data. 


AnyNet I/O Trace Format for SNA over TCP/IP (MVS) 

The format of the AnyNet trace header is described in Table 22 on page 377. Use 
this information to verify the MPTN formats that flow across the IP network. For 
additional information, refer to the VTAM AnyNet Feature for V4R2: Guide to SNA 


over TCP/IP. 


Notes: 


1. The AnyNet trace header is always complete. 


2. The SNA request/response unit (RU) may be truncated. 


3. The trace header identifier is in the same position as the identifier for the buffer 


contents trace. 
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Table 22. Format of the AnyNet Trace Header for SNA over TCP/IP 


Field Field 
Byte Length Description 
0 2 Total record length = n 
2 2 Length of the header (always 32 bytes) 
4 1 Trace type identifier (X'0D') 
5 1 Trace flags 
Bit Meaning 
ee Direction flag 
1 Inbound 
0 Outbound 
~XXX_ XXXX Not used 
6 2 Not used 
8 4 Local internet (IP) address 
12 4 Remote internet (IP) address 
16 2 Local port number 
18 2 Remote port number 
20 8 Timestamp 
28 4 Not used 
32 n-32 MPTN format and SNA request/response unit (RU} 


SMS (Buffer Use) Trace 


The storage management services (SMS) trace records contain information on the 
use and availability of VTAM buffer pools. SMS trace records are written after a 
predetermined number of requests occur for VTAM buffers. An IBM-supplied 
threshold causes a trace record to be written after every 1000 requests. 


Notes: 


1. If the DISPLAY BFRUSE command is issued while this trace is running, the 
fields MAX TOTAL, MAX USED, and TIMES EXP in the output for DISPLAY 
BFRUSE reflect buffer usage only since the last trace record was written, 
because the SMS trace resets these fields. 


2. The SMS trace is not the same thing as the VTAM internal trace with the SMS 
option specified. The SMS trace is similar to the DISPLAY BFRUSE 
command. The SMS trace displays in trace output the same information that 
the DISPLAY BFRUSE command displays on the screen. 


When to Use the SMS Trace 

Use the SMS trace during VTAM installation to evaluate VTAM use of buffer pools, 
to help estimate how many buffers VTAM needs for normal operation, and, with 
dynamic buffering, to limit buffer pool expansions to peak use periods. You can 
use the SMS trace in conjunction with tuning statistics. 
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SMS Trace Operation 

Start the SMS trace with the MODIFY TRACE command, or use the TRACE start 
option with TYPE=SMS and ID=VTAMBUF specified. For more information about 
the MODIFY TRACE command, see “MODIFY TRACE Command” in VTAM Opera- 
tion. For more information about the TRACE start option, see “TRACE for Buffer, 
I/O, NCP Line, SIT, or SMS Traces” in the VTAM Resource Definition Reference. 


Make sure that GTF with the TRACE=USR option is active before starting this 
trace. See “Starting the Generalized Trace Facility (GTF) (MVS)” on page 358. To 
format and print the data recorded by GTF, use IPCS and set USR(FFO) or 
USR(CLO2) on the GTFTRACE option. 


(7) To collect SMS trace information, use the TRSOURCE command. To format 
and print SMS trace output, use the ACF/TAP or TRACERED command. 


Make sure that SDAID is active, and TRACE VTAMBU is specified. The trace 
output can be printed with the DOSVSDMP utility program. See Table 80 on 
page 1165 to determine what book describes SDAID and DOSVSDMP. 


For more information on printing trace output, see See aneting and Printing Trace 
Records” on page 361. 


SMS Trace Record Output (MVS) (VM) 

The SMS trace record format is different for MVS and VM. Figure 43 and 
Figure 44 show examples of SMS trace output. The trace fields are explained in 
Table 23 on page 379. In addition to the fields described here, other operating- 
system-dependent fields may appear. These fields are described in Table 19 on 
page 367 and Table 20 on page 367. 


VTAM BUFFERS MAXU MAXQ AVNO TEXP MBUF TOTL 
10 00000039 00000000 G000016E 90000000 00000190 0000190 
BS 80000000 00000000 90000261 90000000 00000261 60000261 
iP 00000007 00000000 9000003D 00000000 0000040 90000040 
XD 00000000 00000000 BOC9D00A 00000000 CO0OQOOA GO0Q000A 
LF Q000000D 000000008 0000006B 0000000 00000078 00000078 
CR 00000016 00000000 000000B7 680000000 O00000C8 000000C8 
VTAM BUFFERS MAXU MAXQ AVNO TEXP MBUF TOTL 
00000008 00000000 00000038 90000000 00000040 00000040 
SP 00000001 00000000 00000032 90000000 00000032 00000032 
AP 00000000 00000000 90000038 90000000 00000038 60000038 
VTAM CSAUSE - TOTAL @030015B MAX 7FFFFFFF %FREE QUEUE 90000000 


Figure 43. Example of SMS Trace Output 


they may be separated by another trace entry. 


Two separate records will be printed, and 


VTAM BUFFERS MAXU MAXQ AVNO TEXP MBUF TOTL 
10 00000005 00000008 00000129 80000000 0000012C 0000012C 
BS 00000002 00000000 O000001A 90000000 000001C 000001C 
LP 00000006 00000000 00000025 00000000 00000028 00000028 
XD 00000001 00000000 00000006 90000000 90000006 00000006 
LF 00000002 00000000 00000016 000000008 00000018 90000018 

VTAM BUFFERS MAXU MAXQ AVNO TEXP MBUF TOTL 
CR QOOGOQOA 00000000 OO000D0IF 00000000 080000028 90000028 
VE 00000000 00000000 90000000 00000008 90000000 00000000 
SF 00000004 90000000 0000001C 00000000 00000020 00000020 
SP 00000000 00000000 90000002 90000008 80000002 00000002 


VTAM CSAUSE TOTAL 0000000 MAX CQ000000 %FREE QUEUE 90000000 


Figure 44, Example of SMS Trace Output [jj . 
they may be separated by another trace entry. 


Two separate records will be printed, and 


378 VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


SMS Trace 


Table 23. Fields in the SMS Trace 


Field Header 
Pool ID 


MAXU 


MAXQ 


AVNO 


TEXP 


MBUF 


TOTL 


TOTAL 


MAX 


%FREE QUEUE 


Meaning 


Is the first field in each record and identifies the buffer pool. Pool 
IDs and their corresponding buffer pool names are: 


AP Application program pageable poo! (APBUF) 
BS Boundary session block pool (BSBUF) 

CR Copied RPL pool (CRPLBUF) 

lO Fixed I/O pool (IOBUF) 

LF Large fixed pool (LFBUF) 

LP Large pageable pool (LPBUF) 

SF Small fixed pool (SFBUF) 

SP Small pageable pool (SPBUF) 

UE User exit control block (UECB) (obsolete) 

XD XID pool (XDBUF). 


The maximum number of buffers in the pool that are in use at any 
time since the last trace record is written. 


The maximum number of requests for buffers that are queued 
waiting for storage at any time since the last trace record is written. 


The number of available buffers (those not in use at the time the 
trace record is written). 


The number of times the buffer pool is expanded since the last trace 
record is written. 


The maximum number of buffers that are in the pool at any time 
since the last trace record is written. This includes both used and 
unused buffers. 


The total number of buffers that are in the pool at the time this 
record is written. This includes both used and unused buffers. 


The amount of CSA storage in use by VTAM at the time this record 
is written. 


The largest amount of CSA storage used by VTAM since the last 
SMS buffer trace. 


The amount of CSA storage allocated to VTAM that is waiting to be 
freed. 


SMS Trace Record Output (VSE) 
Table 24 on page 380 describes the fields that appear in the SMS trace. 
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Table 24. Fields in the SMS Trace 


Field Header Meaning 
Pool ID Is the first field in each record. It identifies the buffer pool. Pool IDs 
and their corresponding buffer pool names are: | 
BS Boundary session block pool (BSBUF) 
CR Copied RPL pool (CRPLBUF) 
lO Fixed |/O pool (IOBUF) 
LF Large fixed pool (LFBUF) 
LP Large pageable pool (LPBUF) 
SF Small fixed pool (SFBUF) 
SP Small pageable pool (SPBUF) 
XD XID pool (XDBUF). 


Note: Sometimes pool names are not listed. The pool names are 
not available when VTAM is running disabled. 


IN USE Indicates the number of buffers in the pool that are in use at any 
time during the time covered by the snapshot dump. 


MAX ALLOC Indicates the maximum number of buffers in the pool that are in use 
at any time during the time covered by the snapshot dump. 


MAX WAIT Indicates the maximum number of requests for buffers that are 
queued waiting for storage at any time during the time covered by 
the snapshot dump. 


EXPAND Indicates the number of times the buffer pool is expanded during the 
time covered by the snapshot dump. 


MAX AVAIL Indicates the maximum number of buffers that are in the pool at any 
time during the time covered by the snapshot dump. 
CUR AVAIL Indicates the number of buffers that are in the pool at the time the 


snapshot dump is taken. 


TGET/TPUT Trace for TSO/VTAM (MVS) 


The TGET/TPUT trace for TSO/VTAM writes a GTF trace record for each inbound 
and outbound message that uses the TGET/TPUT/TPG interface (SVC 93) 
between a TSO command processor and the VTIOC component of TSO/VTAM. 
Outbound messages are traced before being placed in the VTIOC queue manager 
output buffer. Inbound messages are traced before the data is sent to the TSO 
command processor. 


Note: The TGET/TPUT trace does not trace address space ID TPUTs. 


When to Use the TGET/TPUT Trace 

Use this trace if the failure is restricted to TSO sessions. This trace can help you 
determine whether TSO/VTAM or your TSO command processor is causing the 
problem. For example, if outbound data is correct in the TGET/TPUT trace output, 
but incorrect in the buffer trace output, the problem is probably in TSO/VTAM or 
VTAM. Use the following tables as guidelines to determine where the error is 
occurring: 
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Table 25. Location of TPUT (Outbound) Error 


Direction lf TPUT And Buffer Then Possible 
of Data Trace Data Is: Trace Data Is: Error Is In: 
Outbound Correct Incorrect e VTAM 

¢ TSO/VTAM 


e TPUT option 
e User edit exits 


Outbound Incorrect Trace not required TSO or the 
command processor 


Outbound Correct Correct Network 


Table 26. Location of TGET (Inbound) Error 


Direction lf TGET And Buffer Then Possible 
of Data Trace Data Is: Trace Data Is: Error Is In: 
Inbound Incorrect Correct e VTAM 

e TSO/VTAM 


e TGET option 
e User edit exits 


Inbound Correct Trace not required TSO or the 
command processor 


Inbound Incorrect Incorrect Network 


TGET/TPUT Trace Operation 
_ Start the TGET/TPUT trace with the MODIFY TRACE command and specify 
TYPE=TSO. 


The trace output is a record of inbound and outbound messages for the specified 
TSO user ID. 


Make sure that GTF with the TRACE=USR option is active before starting this 
trace. See “Starting the Generalized Trace Facility (GTF) (MVS)” on page 358. 


To print these trace records, use IPCS and specify either USR(FE2) or USR(APTH) 
on the GTFTRACE option. For more information on printing trace output, see “For- 
matting and Printing Trace Records” on page 361. 


TGET/TPUT Trace Output 

The trace records created by the TGET/TPUT trace have a 12-byte GTF header 
and a 52-byte trace header followed by the data portion of the RU in unformatted 
hexadecimal. The entire RU is traced, but will span several trace entries if it is 
longer than 228 bytes. 


Figure 45 on page 382 shows an example of TGET/TPUT trace output. The trace 
fields are explained after the figure. 
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TGET/TPUT Trace 


1IPCS PRINT LOG FOR USER USER1 


+ 


@ x*xe*x GTFTRACE DISPLAY OPTIONS IN EFFECT **xx 


USR=SEL 
Q@ xxxx GTF DATA COLLECTION OPTIONS IN EFFECT: *x«x 
All GTRACE events requested 
RNIO events traced 


i) 


Release: SP4.2.2 


+0600 
+0020 
+0040 
+0060 
+0086 
+00A0 
+00C0 
+00E0 
+0160 


+0000 
+0020 
+0040 
+0060 
+0080 
+00A0 
+00CO 
+00E0 
+0100 


+9000 
+0020 
+0640 
+0060 
+0080 
+00A0 
+00CO 
+0GE0 
+0100 


weex GTF TRACING ENVIRONMENT ***% 
FMID: JBB4422 


QOEBE380 
ODD5C5E3 
3€C26040 
401D603C 
C55F40C9 
(9404040 
40C2C2C2 
3C4BF240 
3C4FD340 


GMT-09/63/xx 
OHEXFORMAT AID FF FID 6@ EID 


@6EBE380 
@DD5C5E3 
40079996 
F5F6F8F4 
40F1F9F8 
409985A2 
A340E4A2 
E83CD5E3 
A4998540 


GMT-09/03/xx 
@HEXFORMAT AID FF FID 0@ EID 


Q@OEBE380 
@DD5C5E3 
82A840C7 
8840C9C2 
401DE8C5 
C5D3D73C 
DOCSE3E4 
3C5CF240 
5DD840C6 


E4E2C5D9 
C14BC1F5 
1D663CC2 
C44F40C9 
C9404040 
40€24040 
€2464040 
1DE8C9E2 
03898385 


E4E2C5D9 
C14BC1F5 
978599A3 
6OF1F2F3 
FQ6B40F1 
8599A585 
8599A240 
40E4A285 
9985A2A3 


E4E2C5D9 
C14BC1F5 
£2C140C1 
D440C396 
D5E3C5D9 
5B6F40C6 
D9D54040 
C6F77EE4 
F1F@7ED3 


\ 


F1404040 
FOCOFOF7 
7E40C9C9 
(9404040 
40C240C2 
C2404640 
40044040 
D7C661D7 
95A28584 
19:29:49 
EFE2 
F1404640 
FOC9FOF7 
A8409686 
404D0C35D 
FOFOFO4B 
84483CD4 
D98B5A2A3 
6B4084A4 
998983A3 
19:29:49 
EFE2 
F1404040 
FOCOFOF7 
C4D740E2 
99974B3C 
1D60A396 
F27EE2D7 
4040C6F5 
D73C5C7F 
C5C6E33C 


System name: MVS41D25 
CPU Model: 3090 Version: FF Serial no. 373247 
-HEXFORMAT AID FF FID 90 EID EFE2 


E3E2D606 
F2F14040 
C9C94040 
40024040 
40404040 
D4404040 
40D43CC8 
C4C63C4C 


-847841 


E3E2D6D6 
F2F14040 
40C9C2D4 
40C39697 
3CD2F 046 
40401DE8 
998983A3 
97938983 


. 847887 


E3E2D6D6 
F2F14040 
83888584 
D7F0401D 
40839695 
D3C9E33C 
7ED9C6C9 
40C6F87E 


GMT-09/03/xx 19:29:49.892763 


@HEXFORMAT AID FF FID 60 EID EFE2 


+0000 O0EBE380 E4E2C5D9 
+6026 O@DD5C5E3 C14BC1F5 
+6040 40404040 C6FIF27E 


GMT-09/03/xx 
OHEXFORMAT AID FF FID 90 EID 


+0000 QOO0EBE380 E4E2C5D9 
+0020 O@DD5SC5E3 C14BC1F5 
GMT-09/03/xx 19:29:51 
1IPCS PRINT LOG FOR USER USER1 


+ 


F1404040 
FOC9FOF7 
D9C5E3D9 
19:29:49 
EFE2 
F1404040 
FOC9FOF7 


E3E2D6D06 
F2F14040 
C9C5E5C5 


-893415 


E3E2D6C9 
F2F14040 


997746 
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1 16:15:06 09/03/xx 


E4E30300 C9DSC9E3 E4E2C5D9 F1404040 | ..T.USER1 TSOOUT..INITUSER1 

40490000 C111404@ 1D603CC1 50401D60 | .NETA.A5Q10721 ..A. .-.A& .- 
c2c2c2zc2 404040490 04404040 D43CC3FO | .B- .-.B= IIII BBBB MM M.CO | 
(2404048 D4D449D4 D43CC540 461D603C .-.D] II B B MMMM.E .-. | 
04400440 D43CC656 401D603C Cé6F4eC9 | E> II BB MMM.F& .-.F? I | 
D43CC76@ 401D603C C77E4eC9 c9c9c940 | I BB M M.G- .-.G= III | 
F@401D60 3C4A404@ 10603C4B 50401D60 BBBB OM «CoM. HO .-.¢ w-..& - | 
60401066 3C4DFO40 1D603C4F 40401DE8 | ..2 .YISPF/PDF.<- .-.(@ .-.| .¥ | 
.[L Licensed | 

LOC-09/03/xx 15:29:49.753633 

E4E30300 40D4C9C4 E4E2C5D9 F140404@ | ..T.USER1 TSOOUT.. MIDUSER1 | 
40400000 40D481A3 85998981 93A24060 | .NETA.A5010721  =.. Materials - | 
3€505040 1D603CD1 60401DE8 3CD1F34e Property of IBM.&& .-.J- .Y.J3 | 

A8998987 88A340C9 C2D440C3 96999748 | 5684-123 (C) Copyright IBM Corp. 

1DE83CD3 (340C193 93409989 8788A3A2 | 1980, 1990..KO .Y.LC All rights 

3CD4D340 E4E240C7 96A58599 95948595 | reserved..M .Y.ML US Governmen 
858440D9 898788A3 A240603C 0550401D | t Users Restricted Rights -.N& . | 

81A38996 95409699 468489A2 839396A2 Y.NT Use, duplication or disclos 
| ure restrict | 

LOC-09/03/xx 15:29:49.753679 

E4E30300 4@D4C9C4 E4E2C5D9 F1404040 | ..T.USER1 TSOOUT.. MIDUSER1 | 

40400000 85843CD6 60401DE8 3CD6F340 | .NETA.A5010721 ..ed.0- .Y.03 
A4938540 (39695A3 998183A3 40A689A3 | by GSA ADP Schedule Contract wit | 
603CD946 401D603C 5A5@401D 603C5A6E | h IBM Corp..P@ .-.R .-.!& .-.!> | 

A38995A4 853C5B60 40106040 C6F17EC8 .YENTER.-to continue.$- .- F1=H 

5B7C40C6 F37EC5D5 C43C5CC9 40C6F47E | ELP.$? F2=SPLIT.$@ F3=END.*I F4= 

D5C43C5C E340C6F6 7ED9C3C8 C1D5C7C5 | RETURN  F5=RFIND.*T F6=RCHANGE 
C4D6E6D5 3C5D4C40 C6F97EE2 £6C1D73C | .*2 F7=UP.*" F8=DOWN.)< FO=SWAP. | 


LOC-09/03/xx 15:29:49.798555 


E4E30300 D3C1E2E3 E4E2C5D9 F1404040 
40400000 5DE540C6 FI1F17ED9 C9C7C8E3 


40401140 


4613 


)Q F10=LEFT. 


| ..T.USER1 | TSOOUT..LASTUSER1 
| .NETA.A5010721  ..)V F11=RIGHT 
| F12=RETRIEVE 


LOC-09/03/xx 15:29:49.799267 


D5408100 D3C1E2E3 E4E2C5D9 F1404640 


40400060 


704040 


| ..T.USER1 TSOIN a.LASTUSER1 = | 
| .NETA.A5O10721 ~—...' | 


LOC-09/03/xx 15:29:51.903538 


2 16:15:43 09/03/xx 


Figure 45. Example of TGET/TPUT Trace Output 


The following fields appear in the TGET/TPUT trace. The first two bytes in each 
row show the hex offset in storage. The data follows after that. 


Byte 
(hex) 


00-03 
04-0B 
0C-0E 
OF-11 
12 


13 
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Meaning 

ASCB address 

Job name 

C'TSO' 

C'IN' for inbound data (TGET); C'OUT' for outbound data (TPUT) 


TGET/TPUT option flags (See the TGET/TPUT option flags entry in Table 80 
on page 1165 to determine what book describes these bit definitions.) 


TGET: return code (See Table 80 on page 1165 to determine what book 
describes TGET return codes.) 


TPUT: 

X'00' EDIT, ASID, FULLSCREEN, or CONTROL options 
X'01' NOEDIT option 

X'02' TPG macro issued. 

X'03' NOEDIT option specified and TGP macro issued. 
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Byte 

(hex) Meaning 

14-17 C'INIT' for the first 228-byte section of a PIU; C'MID' for the middle 
sections of a PIU; C'LAST' for the last section of a PIU 

18—-1F TSO user ID 

20 Length of network-qualified name 

21-31 Network-qualified name 

32-33 Zero 

34 Start of user data. 
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Traces Provided by NCP 


NCP provides several kinds of traces to record the flow of network events. Each 

trace occurs at a different point in the network (See Figure 33 on page 348). This 

allows you to follow an RU through the network and determine where in the 

network the RU is incorrect. (The RU could be out of sequence or lost, the data in 
_ the RU could have been changed, and so forth.) 


The NCP traces are: 


e “Generalized PIU Trace” 

e “Line Trace” on page 385 

e “Network Controller Line Trace (3710 Only)” on page 389 

e “Scanner Interface Trace (3720, 3725, and 3745 Only)” on page 390 
e “Transmission Group Trace” on page 391. 


To determine what bock contains more information on NCP service aids, see 
Table 80 on page 1165. 


Generalized PIU Trace 


The generalized PIU trace collects PIU trace data collected by the NCP. The 
resulting trace output shows the flow of PIUs exchanged between the NCP and its 
attached resources. This trace is hierarchical when started for a physical unit or a 
line. That is, logical units associated with the physical unit are automatically traced 
when traffic flows to them. Likewise, when the generalized PIU trace is started for 
a line, physical units and logical units associated with the line are automatically 
traced when traffic flows to them. When the generalized PIU trace is stopped for a 
physical unit, the trace is reset for all logical units associated with the physical unit, 
regardless of how the generalized PIU trace was started. 


When to Use the Generalized PIU Trace 
Use the generalized PIU trace to trace PIU data at the NCP level and to determine 
whether the NCP has received or sent PIU data. 


Note: VTAM can start a generalized PIU trace only for the resources that it owns. 
A data host, which does not own any NCPs, cannot start a generalized PIU trace 
for an NCP or any of the NCP's subordinate resources. 


Generalized PIU Trace Operation 

Start the generalized PIU trace with the MODIFY TRACE command. For more 
information on the MODIFY TRACE command for the generalized PIU trace, see 
“MODIFY TRACE Command” in VTAM Operation. 


Make sure that GTF with the TRACE=USR option is active before starting this 
trace. See “Starting the Generalized Trace Facility (GTF) (MVS)” on page 358. 


Ri To collect generalized PIU trace information, use the TRSOURCE command. 
To format and print generalized trace output, use ACF/TAP. 


Use ACF/TAP with INPUT=GPT to format and print the trace output. 


For more information on printing trace output, see “Formatting and Printing Trace 
Records” on page 361. 
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Line Trace 


The line trace, a joint function of VTAM and the NCP, records the status of a line 
each time the NCP receives data from or sends data to that line. Although the 
trace is controlled by VTAM, the information in the trace records is collected by the 
NCP. The NCP sends the data to VTAM in a PIU. A trace type indicator in the 
PIU indicates whether the trace is a byte line trace (type 2 scanner) or a block line 
trace (type 3 scanner). 


Note: If the data is not from a type 1, 2, or 3 scanner, VTAM will not process the 
data. You must use ACF/TAP. 


The line trace collects the operating parameters of a line each time a level 2 inter- 
ruption occurs on that line. 


e For a 3705 Communications Controller with a type 2 communication scanner, a 
level 2 interruption occurs each time a byte of data is sent or received across 
the line. | 


e For a 3705 Communications Controller with a type 3 communication scanner, a 
level 2 interruption occurs each time an NCP buffer is filled and the buffer data 
is sent or received across the line. 


e For a 3720, 3725, or 3745 Communication Controller, a level 2 interruption 
occurs each time a message (an entire PIU) is sent or received. 


You can use the line trace only for lines attached to a communication controller and 
operating in network control mode. 


For each 3705 Communications Controller, as many as eight line traces can be 
active at a time. For each 3720, 3725, or 3745 Communication Controller, a com- 
bination of eight line or scanner interface traces can be active at one time. 


The number of active line traces to be allowed is specified during NCP generation 
(default = 2). In a cross-domain network in which the communication controller is 
connected to more than one host processor, the number of active traces allowed is 
distributed among the connected host processors on a first-come, first-served basis. 


Note: As the number of active line traces increases, the system becomes less 
efficient. | 


When to Use the Line Trace 

You might use this trace if you suspect a problem with a device attached to a com- 
munication controller. If data appears correctly in the line trace but the terminal or 
printer does not react appropriately, the device itself is probably causing the failure. 


Before using a line trace, you should use buffer and I/O traces to verify that the 
problem is not in VTAM or an application program. You may also want to use the 
scanner interface trace (for 3720, 3725, and 3745 Communication Controllers only), 
which traces data after it has been processed by the NCP and before it leaves the 
communication controller. Therefore, it can help determine whether the problem is 
in the NCP or in the line. 


Note: VTAM can start a line trace only for the resources that it owns. A data 
host, which does not own any NCPs, cannot start a line trace for an NCP or any of 
the NCP's subordinate resources. 
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You might want to use a transmission group (TG) trace instead of or in addition to 
this trace. If there is more than one active line in a transmission group, and you do 
not know which line is causing the problem, use the transmission group trace. The 
transmission group trace also shows more data than the line trace. 


A line trace can be active for any line in the transmission group. However, a line 
trace and a transmission group trace cannot be active for the same line, at the 
same time. 


Line Trace Operation 

Start the line trace with the MODIFY TRACE command or the TRACE start option. 
In either case, specify TYPE=LINE. For more information on the MODIFY TRACE 
command, see “MODIFY TRACE Command” in VTAM Operation. For more infor- 
mation on the TRACE start option, see “TRACE for Buffer, I/O, NCP Line, SIT, or 

SMS Traces” in the VITAM Resource Definition Reference. 


Make sure that GTF with the TRACE=USR option is active before starting this 
trace. See “Starting the Generalized Trace Facility (GTF) (MVS)” on page 358. 


To format and print line trace data for a 3705, 3720, 3725, or 3745, use ACF/TAP 
and specify INPUT=LINE. 


Ru) To format and print line trace data for a 3705, use ACF/TAP or TRACERED. 
For ACF/TAP, specify INPUT=LINE. 


R70] To format and print line trace data for a 3720, 3725, or 3745, use ACF/TAP 
and specify INPUT=LINE. 


To format and print line trace data for a 3705, use ACF/TAP or TPRINT. For 
TPRINT, specify LINE=name or LINE=ALL. For ACF/TAP, specify INPUT=LINE. 


To format and print line trace data for a 3720, 3725, or 3745, use ACF/TAP 
and specify INPUT=LINE. 


For more information on printing trace output, see “Formatting and Printing Trace 
Records” on page 361. 


Line Trace Output (CS Type 2) 
Figure 46 shows an example of line trace output for a 3705 Communications Con- 
troller with a type 2 communication scanner. 


The trace fields are explained after the figure. In addition to the fields described 
here, additional operating-system-dependent fields may appear. For a description 
of these fields, see Table 19 on page 367 and Table 20 on page 367. 


LINE LINE@1 LRC(000,000) INBOUND ACTIVE RNTIME=1D 
LCD C PCF A TIME 16 SCF 42 PDF D4 LCD C PCF A TIME 16 SCF 42 PDF 40 
LCD C PCF A TIME 16 SCF 42 PDF E5 LCD C PCF A TIME 16 SCF 42 PDF 40 
LCD C PCF A TIME 16 SCF 42 PDF E3_ LCD C PCF A TIME 16 SCF 42 PDF 40 
LCD C PCF A TIME 16 SCF 42 PDF C1 LCD C PCF A TIME 16 SCF 42 PDF 40 


Figure 46. Example of Line Trace Output (CS Type 2) 
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Line Trace 


The following fields appear in the line trace for CS type 2. 


The header portion of the line trace record contains these fields: 


Field Header 


LINE linename 


LRC(xxx, yyy) 


INBOUND 


status 


RNTIME=hh 


Field Contents 


The name of the node being traced. In Figure 46, the line name is 
LINEO1. 


The number of records lost since the last trace record was written 
because the trace facility could not get a VTAM buffer. xxx is the 
destination's lost record count, and yyy is the source's lost record 
count. 


The direction of the data with respect to this host. It 
always says INBOUND because VTAM always receives the trace 
records from the NCP. [{{@ This field is replaced by a time stamp. 


The status of the line being traced. In Figure 46, the line status is 
ACTIVE. The line status may also appear as DEACTIVATE or 
SLOWDOWN. 


e ACTIVE means that the line trace is active. 
¢ DEACTIVATE means that the line trace is not active. 


e SLOWDOWN means that the line trace is not active because 
the NCP is in slowdown mode. 


A status of DEACTIVATE or SLOWDOWN appears only in the last 
record to be sent for that line. It means that no more data will be 
sent until the trace is activated again for that line. 


Is a timer field. hh is a hexadecimal value indicating in tenths of a 
second the time at which the communication controller sent the 
completed line trace record to VTAM. This value is taken from a 
timer that is reset to 0 after 25.5 seconds. This value can be com- 
pared with the TIME value for the first level 2 interruption data con- 
tained in the second part of the line trace record. This comparison 
shows the elapsed time covered by this trace record. Comparing 
this with the number of level 2 interruptions contained in the trace 
record indicates the |/O activity during the elapsed time. 


The data portion of the line trace record contains a timer value and values from the 
interface control word (ICW) and communication controller hardware registers at 
each level-2 interruption. Each printed line contains up to two sets of data, one for 
each of two level-2 interruptions. 


To determine what book contains detailed descriptions of the fields in line trace 
records, see Table 80 on page 1165. 


Field Header 
LCD 


PCF 
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Field Contents 


The line control definer (LCD) indicates the type of protocol being 
used over the line. The LCD for a line is generally set when the 
NCP is loaded and remains unchanged throughout normal operation. 


The primary control field (PCF) indicates the state of the line inter- 
face at any particular time. 
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Field Header Field Contents 


TIME This hexadecimal value indicates, in tenths of a second, the time 
elapsed between level-2 interrupts as they occur on the line interface 
as data is received. Level-2 interrupts are represented by the data 
(PDF). The value of this timer is reset to 0 every 25.5 seconds. 


SCF The secondary control field (SCF) is used as a status and operation 
modifier by the communication scanner and the control program. 


PDF The parallel data field (PDF) is used as a character buffer. Fora 
transmission, the program places the characters to be sent in the 
PDF, and transmits them to the line interface. For a receive opera- 
tion, the character is assembled, then transferred by hardware to the 
PDF. 


Line Trace Output (CS Type 3) 

Figure 47 shows an example of line trace output for a 3705 Communications Con- 
troller with a type 3 communication scanner. This trace record shows the operating 
status of a line each time an NCP buffer is filled, instead of each time a character 
is transmitted. 


The output in this example applies to all MVS, VM, and VSE utilities, except 
ACF/TAP. MVS, VM, and VSE utilities produce similar output for line traces; the 
differences are noted in the following text. 


The trace fields are explained after the figure. Most fields in this record are similar 
to the example for the type 2 scanner, but the type 3 scanner has some additional 
fields. To determine what book contains detailed descriptions of the additional 
fields in CS type 3 output, see Table 80 on page 1165. 


LINE LINEQ1 LRC(000,000) INBOUND ACTIVE RNTIME=1D 
STATUS SCF LCD PCF EPCF STAT1 STAT2 TIME ADDR CNTL IOBLXB DISP ICW CCBLV 
449 9 00 00 601 80 03 71 30 AA 11° 1BB2 
TEXT COQB4 


Figure 47. Example of Line Trace Output (CS Type 3) 


In addition to several fields shown in the line trace for CS type 2, the following 
fields appear in the line trace for CS type 3: 


Field Header Field Contents 


EPCF The extended primary control field. These bits extend the meaning of the 
PCF. 

STAT1 Status byte 14 of the ICW. 

STAT2 Status byte 15 of the ICW. 

TIME This hexadecimal value indicates, in tenths of a second, the time elapsed 


between level-2 interrupts as they occur on the line interface as data is 
received. Level-two interrupts are represented by the data. The value of 
this timer is reset to 0 every 25.5 seconds. 


ADDR The SDLC frame address field. 
CNTL- The SDLC frame control field. 
lOBLXB The 1-byte command field from the |OB/LXB control block. 
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Field Header Field Contents 


DISP or DISP or [¥ XDISP is byte 0 from the communication 

XDISP scanner display register. 

ICW Byte 13 of the interface control word. 

CCBLV or CBBLV or [{{JLVL2 is the address of the level 2 interruption 

LVL2 processor routine, taken from field CCBL2 in the NCP CCB control block. 

TEXT The contents of the NCP buffer being transmitted in both hexadecimal and 
EBCDIC. 


Network Controller Line Trace (3710 Only) 


The network controller line trace traces SDLC, BSC, and start/stop data link control 
frames sent or received by an IBM 3710 Network Controller. 


The 3710 physical unit provides a network controller line trace on a physical unit 
type 2 node. The network controller line trace traces data link control (DLC) proto- 
cols, such as DLC frames exchanged between a network controller and an NCP, or 
DLC frames exchanged between a network controller and a control unit. 


The network controller line trace facility also traces the synchronous data link 
control (SDLC), binary synchronous control (BSC), and start/stop DLC frames that 
are sent or received by a line adapter. 


When tracing an SDLC or BSC line, you can choose to trace all the frames (control 
and data) or just the data frames. All frames are traced on a start/stop line. 


Note: If the data is not from a type 1, 2, or 3 scanner, VTAM will not process the 
data. You must use ACF/TAP. 


When to Use the Network Controller Line Trace 
Run this trace if you have an incorrect output problem, a performance problem, or 
you suspect a network controller problem. 


Network Controller Line Trace Operation 

Start the network controller line trace with the MODIFY TRACE command. For 
more information on the MODIFY TRACE command for the network controller line 
trace, see “MODIFY TRACE Command” in VTAM Operation. 

Active traces stop if: 


e The network controller is reset (for example, during a failure or a configuration 
load) 


e The network controller enters slowdown (shown in the header of the RECTRD 
RU) 


e The line fails during the trace. 


If the network controller recovers after a failure, and it is not the only one on the 
line, the trace will resume. 


Make sure that GTF is active before starting this trace. See “Starting the General- 
ized Trace Facility (GTF) (MVS)” on page 358. 
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Use ACF/TAP with NETCTLR specified to format and print the output. For more 
information on printing trace output, see “Formatting and Printing Trace Records” 
on page 361. 


Network Controller Line Trace Output 
VTAM receives the trace data from a network controller in a series of RECTRD 
RUs, which are put into trace records. Use ACF/TAP to print the trace output. 


Scanner Interface Trace (3720, 3725, and 3745 Only) 


The scanner interface trace, a joint function of VTAM and the NCP, stores the oper- 
ating parameters of a line whenever a 3720, 3725, or 3745 Communication Con- 
troller sends or receives a message. Although the trace is controlled by VTAM, the 
information in the trace records is collected by the NCP. The scanner interface 
trace collects the operating status of a line whenever the communication controller 
sends or receives a message (PIU). 


When you start the trace, you can choose how many bytes of data you want to 
trace. The default is the entire PIU. You can only use the scanner interface trace 
on lines operating in network control mode. 


For each communication controller, a combination of eight line traces or scanner 
interface traces can be active at a time. The number of active scanner interface 
traces to be allowed is specified during NCP generation (default = 2). In a multi- 
system network in which the communication controller is connected to more than 
one host processor, the number of active traces allowed is distributed among the 
connected host processors on a first-come, first-served basis. 


Note: As the number of active scanner interface traces increases, the system 
becomes less efficient. 


When to Use the Scanner Interface Trace 

Use the scanner interface trace to determine whether the NCP or a line is causing 
a problem. The scanner interface trace collects inbound data before the NCP proc- 
esses it, and collects outbound data after the NCP processes it. Therefore, if out- 
bound data is correct in a scanner interface trace, but the device does not react 
properly, the problem is in either the line or the device. | 


Scanner Interface Trace Operation 

Start the scanner interface trace with the MODIFY TRACE command or the TRACE 
start option. The COUNT option allows you to choose how many bytes of data you 
want traced (0 to 254 or ALL). The default is the entire PIU. 


For more information on the MODIFY command for the scanner interface trace, see 
“MODIFY TRACE Command” in VTAM Operation. For more information on the 
TRACE start option, see the “TRACE for Buffer, I/O, NCP Line, SIT, or SMS 
Traces” in the VTAM Resource Definition Reference. 


Make sure that GTF with the TRACE=USR option is active before starting this 
trace. Use ACF/TAP with INPUT=LINE to format and print the output. 


[J To collect scanner interface trace information, use the TRSOURCE command. 


To format and print scanner interface trace output, use ACF/TAP. 
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Use ACF/TAP to format and print the output. 


For more information on printing trace output, see “Formatting and Printing Trace 
Records” on page 361. 


Transmission Group Trace 


The transmission group (TG) trace, a joint function of VTAM and the NCP, traces 
the sequence of PIUs being sent through a transmission group. The transmission 
group trace shows PIU traffic on a transmission group as though the transmission 
group were a Single line. The sequence of PiUs traced is the sequence of their 
entry to and exit from the transmission group, not the sequence of actual trans- 
mission along the physical lines in the transmission group. The line trace shows 
the sequence of PIUs transmitted and received on a physical line. 


When to Use the Transmission Group Trace 

Use the transmission group trace instead of a line trace if your failure is restricted 
to sessions using a specific transmission group and you have more than one active 
line ina TG. 


Note: VTAM can start a transmission group trace only for the resources that it 
owns. A data host, which does not own any NCPs, cannot start a transmission 
group trace. 


Transmission Group Trace Operation 

Start the transmission group trace with the MODIFY TRACE command. The name 
specified in the ID operand is any line “associated” with the transmission group 
trace. The trace is started for the transmission group in which the specified line 
resides. This line and its associated link station must be active before the trans- 
mission group trace is started. If a line trace is already active for the chosen line 
within a transmission group, you must stop it before starting a transmission group 
trace. 


Once activated, the transmission group trace remains active until one of the fol- 
lowing occurs: 


e The operator stops the trace. 

e The associated line or link station is deactivated or fails. 
e The NCP goes through automatic network shutdown. 

¢ The NCP goes into slowdown mode. 


If the transmission group trace is ended because the associated line or link station 
fails or is deactivated, the operator can restart it by issuing the MODIFY command 
for another line in the TG. 


For more information on the MODIFY TRACE command for the transmission group 
trace, see “MODIFY TRACE Command?” in VTAM Operation. 


Note: If the data is not from a type 1, 2, or 3 scanner, VITAM will not process the 
data. You must use ACF/TAP. 


Make sure that GTF with the TRACE=USR option is active before starting this 
trace. See “Starting the Generalized Trace Facility (GTF) (MVS)” on page 358. 
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Use IPCS or ACF/TAP to format and print these trace records. For IPCS, specify 
USR(LINE) or USR(FF2) on the GTFTRACE option. For ACF/TAP, specify 
INPUT=LINE. 


Ri] To collect transmission group trace information, use the TRSOURCE 
command. To format and print trace output, use the ACF/TAP or TRACERED 
commands. 


To format and print transmission group trace output, use TPRINT or 
ACF/TAP. 


For more information on printing trace output, see “Formatting and Printing Trace 
Records” on page 361. 


Transmission Group Trace Output (MVS) (VM) 


Figure 48 is an example of transmission group trace records 


The trace fields are explained after the figure. In addition to the fields described 
here, additional operating system-dependent fields may appear. For a description 
of these fields, see Table 19 on page 367 and Table 20 on page 367. 


LINE  LINE23 LRC(000,000) INBOUND ACTIVE RNTIME=00 
TEXT 42000000 2000009A 00000004 OQ00000C OEQ0000B 
0005808D OQOACB80 O0A0 
TEXT 6EQ00000 FOQO009A 00000004 00000001 90000000 
00000032 20000000 00000823 00000000 00000000 
00000123 00000040 


Figure 48. Example of Transmission Group Trace Output 
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Transmission Group Trace 


Table 27 describes the fields in the transmission group trace. 


Table 27. Fields in the Transmission Group Trace 


Field Header 


LINE finename 


LRC(xxx, yyy) 


INBOUND 


Status 


RNTIME=hh 


TEXT 


Meaning 


The name of the line “associated” with the transmission group 
trace. This line name was specified in the MODIFY TRACE 
command that started the transmission group trace. The line name 
is LINE23 in Figure 48 on page 392. | 


The number of records lost since the last trace record was written 
because the trace facility could not get a VTAM buffer. xxx is the 
destination's lost record count, and yyy is the source's lost record 
count. 


The direction of the data with respect to this host. It always says 
INBOUND because the data is always received from the NCP. 


The status of the line being traced. In Figure 48, the line status is- 
ACTIVE. The line status may also appear as DEACTIVATE or 
SLOWDOWN. 


e ACTIVE means that the line trace is active. 
e DEACTIVATE means that the line trace is not active. 


e SLOWDOWN means that the line trace is not active because 
the NCP is in slowdown mode. 


A status of DEACTIVATE or SLOWDOWN appears only in the last 
record to be sent for that line. It means that no more data will be 
sent until the trace is activated again for that line. 


Is a timer field, where hh is a hexadecimal value indicating, in 
tenths of a second, the time at which the communication controller 
sent the completed line trace record to VTAM. This value is taken 
from a timer that is reset to 0 every 25.5 seconds. This value can 
be compared with the TIME value for the first level 2 interruption 
data contained in the second part of the line trace record. This 
comparison shows the elapsed time covered by this trace record. 
Comparing this with the number of level 2 interruptions contained in 
the trace record indicates the I/O activity during the elapsed time. 


Shows the TH and RH for each PIU that traversed the data path 
through the transmission group. If the PIU is for data flow control, 
session control, or network control, the full RU portion of the PIU is 
also included in the trace record. The RU may contain sense data. 
If the PIU is function management data (FMD) and contains an FM 
header, six bytes of the RU are included in the transmission group 
trace record. If an FMD PIU without an FM header is traced, the 
RU is not included. 


Transmission Group Trace Output (VSE) 
Figure 49 is an example of transmission group trace records. The trace fields are 
explained after the figure. 


LINE  LINE23 87.150/09:15:06.18 ACTIVE RNTIME=00 

TEXT 42000000 2000009A 00000004 GO0OHOOC HEQOOOOB 0005808D OOGACB8O OGACOD0O 
00000032 20000000 00050101 O000000B 0040 

TEXT 6E0Q0000 FODQOO9A 00000004 00000001 00000000 0005808D OBOOACB8E OOAQ000O 
00000123 00000040 00050101 O000000B 0000 


Figure 49. Example of Transmission Group Trace Output’ 
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Table 28 on page 394 describes the fields that appear in the transmission group 


trace for VSE. 


Table 28. Fields in the Transmission Group Trace 


Field Header 


LINE linename 


yy.jjj/hh:mm:ss.hh 


LRC(xxx, yyy) 


TRANSMIT or RECEIVE 


status 


RNTIME=hh 


TEXT 
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Meaning 


Is the name of the line associated with the transmission group 
trace. This line name was specified in the MODIFY TRACE 
command that started the transmission group trace. The line 
name is LINE23 in Figure 49 on page 393. 


Is the year (yy), the Julian date (jjj), and the time in hundredths 
of a second (hh:mmiss.hh) that the trace record was written. 


This field is “87.150/09:15:06.18” in the first trace record in 
Figure 49 on page 393. | 


Is the number of records lost since the last trace record was 
written because of the inability of the trace facility to get VTAM 
buffers. xxx is the destination's lost record count, and yyy is 


the source's lost record count. This field is not present in the 


trace record unless records are lost. 


Indicates, for full-duplex lines, the side of the line used for the 
transmission. 


The status of the line being traced. In Figure 49, the line 
status is ACTIVE. The line status may also appear as DEAC- 
TIVATE or SLOWDOWN. 


e ACTIVE means that the line trace is active. 
e DEACTIVATE means that the line trace is not active. 


e SLOWDOWN means that the line trace is not active 
because the NCP is in slowdown mode. 


A status of DEACTIVATE or SLOWDOWN appears only in the 
last record to be sent for that line. It means that no more data 
will be sent until the trace is activated again for that line. 


Is a timer field, where hh is a hexadecimal value indicating, in 
tenths of a second, the time at which the communication con- 
troller sent the completed line trace record to VTAM. This 
value is taken from a timer that wraps around to 0 after 25.5 
seconds. This value can be compared with the TIME value for 
the first level 2 interruption data contained in the second part 
of the line trace record. This comparison will show the 
elapsed time covered by this trace record. Comparing this 
with the number of level 2 interruptions contained in the trace 
record indicates the I/O activity during the elapsed time. 


Shows the TH and RH for each PIU that traversed the data 
path through the transmission group. If the PIU is data flow 
control, session control, or network control, the full RU portion 
of the PIU is also included in the trace record. The RU may 
contain sense data. If the PIU is function management data 
(FMD) and contains an FM header, six bytes of the RU are 
included in the transmission group trace record. If an FMD 
PIU without an FM header is traced, the RU is not included. 
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Dynamic Trace Utility for Integrated Communication Adapters 
(VM)(VSE) 


This trace facility of VSE applies to ESA-capable processors. It can record commu- 
nication adapter line traces on tape while the line and the communication adapter 
are both active. It can also print selected trace entries after a line-related error has 
occurred. 


The communication adapter line trace should be used when line-related errors are 
suspected on lines attached to the integrated communication adapter (ICA), for 
example: 


e Frequent unexplained line outages 
e Unusual sense or status in I/O error messages 
e Device outages that cannot be explained with |/O or buffer traces. 


see Table 80 on page 1165 to determine what book describes dynamic tracing of 
ICAs. 
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Chapter 9. Using the VTAM Internal Trace (VIT) 


This chapter includes the following sections: 
e “Activating the Internal Trace” on page 398 


— “Selecting Trace Options” on page 398 

— “Internal and External Trace Recording” on page 401 

— “Module Names in Internal Trace Records” on page 405 
— “SNAP Trace Record” on page 408 


e “Deactivating the VTAM Internal Trace” on page 410. 


Most VTAM traces show the information flow between the VTAM program and 
other network components. However, the VTAM internal trace (VIT) provides a 
record of the sequence of events within VTAM. These internal events include the 
scheduling of processes (for example, POST, WAIT, and DISPATCH), the manage- 
ment of storage (for example, VTALLOC), and the flow of internal PIUs between 
VTAM components. 


Together with the operator console listing and a dump, output from the VIT can 


help you reconstruct sequences of VTAM events and find internal VTAM problems 
more easily. 
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Activating the Internal Trace 


Trace data for the following VIT options is always automatically recorded in the 
internal table: 


Use one of the following methods to start the VIT: 


e You can use the TRACE start option, with TYPE=VTAM specified, to start the 
VIT when you first start VTAM. See “TRACE for VTAM Internal Trace” in the 
VTAM Resource Definition Reference for more information on how to use the 
TRACE start option. 


e You can use the MODIFY TRACE command, with TYPE=VTAM specified, to 
start the VIT after you have started VTAM. See “MODIFY TRACE Command” 
in VTAM Operation for more information on how to use the MODIFY TRACE 
command. 


Notes: 


1. To prevent the VIT table from being overwritten, VTAM disables the 
internal VIT when it issues SDUMP and when a FFST probe is tripped. 


2. The minimum trace table size is 50 pages. Because the five trace option 
defaults are always running, the table may wrap many times. 


Selecting Trace Options 


Both the TRACE start option and the MODIFY TRACE command have an OPTION 
operand you can use to select VIT options. Select one or more of the following 
options to indicate the VTAM functions you want to trace. 


Note: If you do not deactivate the VIT before you attempt to change an option, the 
options that are currently in effect will remain in effect. See “Deactivating the 
VTAM Internal Trace” on page 410 for more information on deactivating the VIT. 


e API option (for application program interfaces) 


This option helps you determine whether an application program is causing a 
problem. API entries are written for RPL macros, RPL exit routines, user exit 
routines, and user posts. 


Trace data for this option is always automatically recorded in the internal table. 
e APPC option (for LU 6.2 application program interfaces) 


This option helps you determine whether an LU 6.2 application is causing a 
problem. LU 6.2 entries are written for APPCCMD macro invocations, user 
posts and exit scheduling by LU 6.2 code, calls to a security manager for secu- 
rity processing, and message unit transmissions between LU 6.2 components. 
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6 CFS option (for coupling facility interfaces) 


This option helps you determine problems with VTAM's interface with the MVS 
coupling facility. CFS entries are written when VTAM issues MVS macros to 
request coupling facility related services. 


e CIO option (for channel input and output) 


This option helps you isolate problems related to channel I/O. CIO entries are 
written for attentions, error recovery, interruptions, HALT I/O SVC, and START 
VO SVC. 


e ESC option (for execution sequence control) 
This option helps you track in detail the flow of requests for a given process. 
e LCS option (for local area network (LAN) channel stations) 


This option helps you isolate problems occurring during activation of, deacti- 
vation of, and data transfer from an IBM 3172 Interconnect Controller. The 
LCS option enables tracing of data that VTAM receives from an IBM 3172 
Interconnect Controller at four levels: LCSX (channel), LCSP (port or adapter), 
LCSS (SAP), and LCSL (line). 


e LOCK option (for locking and unlocking) 

This option helps you determine when VTAM modules get and release locks. 
e MSG option (for messages) 

This option helps you: 


— Correlate other VIT entries with the console messages even if you lose the 
console sheet. MSG entries are written for all messages to the VTAM 
operator. 


— Match the console log to a surge of activity shown in the VIT. OPER 
entries are written for all VTAM commands issued at an operator console. 


Trace data for this option is always automatically recorded in the internal table. 
e NRM option (for network resource management) 


This option helps you follow the services of the network resource management 
component. These include the assignment of, references to, and the deletion 
of certain VTAM resources such as node names, network addresses, and 
control blocks. NRM entries are written for SRT macros issued by VTAM 
modules. 


Trace data for this option is always automatically recorded in the internal table. 
e PIU option (for path information unit flows) 


This option, like the I/O and buffer contents traces, helps you isolate problems 
to hardware, to the NCP, or to VTAM. Unlike I/O and buffer contents traces, 
with this option PIU entries are written for all PIUs that flow internal and 
external to VTAM. 


Trace data for this option is always automatically recorded in the internal table. 
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PSS option (for process scheduling services) 


This option helps you track the flow of requests through VTAM. PSS entries 
are written for the VTAM macros that invoke and control PSS, scheduling and 
dispatching VTAM routines. 


SMS option (for storage management services) 


This option helps you isolate problems caused by storage shortages. When 
used with the SSCP or PSS trace options, it can also help you isolate internal 
VTAM problems. SMS entries are written when SMS macros are used to 
request or free fixed- or variable-length buffers. SMS entries are also written 
when VTAM expands or attempts to expand a buffer pool. 


SSCP option (for system services control point request scheduling and 
response posting) 


This option helps you isolate a VTAM problem to a specific VTAM component 
or module. SSCP entries are written for the request/response units (RUs) sent 
between VTAM components. This option also records information for the 
APPN CP. 


Trace data for this option is always automatically recorded in the internal table. 


TCP option (for use with the SNA over TCP/IP feature application 
program interfaces) 


This option helps you trace the communication between VTAM and TCP/IP. 
Events include: 


— Socket API calls and completions 

IUCV calls and completions 

invocations of the SOCTREE macro, which controls updating a binary tree 
of socket control blocks 

Tracing MPTN formats 


VCNS option (for VCNS application program interfaces) 


This option helps you determine whether a VCNS application is causing a 
problem. VCNS entries are written for VCNSCMD macro invocations, user 
posts, and exit scheduling by VCNS code, and work element transmissions 
between VCNS components. | 


The VIT always traces the exception conditions listed in Table 29 and all the 
default VIT options listed under “Activating the Internal Trace” on page 398. 


Table 29 (Page 1 of 2). Exception Conditions Always Traced by the VTAM Internal Trace 


Option Exception conditions traced 

APPC option : e ACA and ACI entries when issuing the following commands: 
— SEND ERROR 
—- DEALLOC ABNDxxxx 
— REJECT 


e ACRC and ACSN entries 


e Other entries with non-zero return codes (except RPL6RCSC) 


CFS Entries with non-zero return codes 
LCS option LCSL, LCSP, LCSS, and LCSX entries with non-zero reason codes 
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Table 29 (Page 2 of 2). Exception Conditions Always Traced by the VTAM Internal Trace 


Option Exception conditions traced 

SMS option Entries with non-zero return codes and EXPN entries if a buffer pool 
expansion fails 

(No option) All SNAP entries. 


Table 30 summarizes the VIT options and the records they create. 


Table 30. VIT Options and the Records — Create 


Notes: 


1. The **** (FFST), ABND, and LOST trace records are not activated by specific 
VIT options. They are activated as a result of exception conditions. 


2. The entries in boldface type are forced, that is, always traced even if they are 
not specified by the user. 


Internal and External Trace Recording 
VTAM can write the VIT trace data to an internal table or an external device, such 
as a disk or tape. You specify internal or external with the MODE operand of the 
TRACE start option or the MODIFY TRACE command. The VIT record contains 
the same information regardless of the MODE selected. 


You can record data externally and internally at the same time, and if 
desired, you can have different sets of trace options active for each mode. The 
default trace options— API, MSG, NRM, PIU, and, SSCP—are always recorded 
internally. 


Recording Traces in Internal Table (MODE=INT) 

If you set MODE=INT on the MODIFY TRACE command or as a TRACE start 
option, or if you let MODE default to INT, VTAM writes the VIT trace records in an 
internal trace table. The table is allocated and initialized in a storage area: 


The storage area is in extended common service area (CSA). 
RS] The storage area is in common storage. 
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E2C3C8C4 
E2D9C2C4 
E2D9C2E7 
C9D9C2C4 
D9C5D8E2 
C4E2D740 
C3C3C900 
D8E4C558 
C5E7C9E3 
D9C5D3E2 
C4E2D740 
D8E4C558 
C5E7C9E3 
D9C5D8E2 
C4E2D740 
C5E7C9E3 


14202810 
14000000 
14000000 
14000000 
14170000 
1400A810 
14588000 
14482410 
14000010 
14170000 
14582410 
14482810 
14000010 
14170000 
14582810 
14000010 
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e [a The storage area is in the extended system GETVIS area (SGA). 


The SIZE operand of the TRACE start option specifies the number of pages 
(1-999) in storage to be allocated for the internal trace table. Each page is 4K. If 


- you omit this option, the default size is 50 pages. If you specify fewer than 50 


pages, VTAM uses 50. Because it is a wraparound table, specify enough pages to 
ensure that the VIT will not overwrite important trace records when the table fills 
and begins to wrap around. 


The SIZE operand should also reflect the amount of storage available for the 
internal trace table. If there is not enough storage available for the number of 
pages specified, you will receive a message indicating that internal trace activation 
failed. 


After the VIT is started, the size operand does not have a default. You can change 
the size of the internal trace table by issuing a MODIFY TRACE command with a 
new SIZE operand. However, if you change the table size while the VIT is running, 
the current internal trace table is freed, and VTAM starts a new one. Therefore, the 
trace information in the current table will be lost. 


Figure 50 shows an example of VTAM internal trace records written with 


MODE=INT and printed in dump output. The five default trace options are always 


06308E88 00C17248 
Q6308E88 80000000 
06308E88 00000000 
06308E88 80000000 
06308E88 06324810 
06308E88 00017248 
06324A20 00000000 
06308E88 00017908 
06308E88 00C17248 
06308E88 06324810 
Q6308E88 00017908 
Q6308E88 00017248 
Q6308E88 00C17908 
06308E88 06324810 
06308E88 00017248 


active. 
8652D180 00000000 C9D5E3D4 Q0000000 * SCHD.......h.A..f.J INTM. * 
00000000 60000000 007FF158 09800000 * SRBD....... Hevenereraned re * 
00000000 OOEBDE80 OOEBDE8O 824C4B82 * SRBX....... Nieiewteateseenns b<.b * 
00C17248 ©07DDB18 OO7FF158 00800000 * IRBD....... Rideak ee) eee * 
81C23E1A 00010000 O6300DAO 00000000 * REQS....... Hat a Beta nta es x 
00000000 0000000 C9D5E3D4 06324810 * DSP ..y....h.Ac..ceceeee INTM * 
8652D13A 00000000 58588000 00000000 * CCI....... Geseee Paloticeteweeces * 
S24EAABC 06510928 EZEZE6E4 06324810 * QUE........ h.A..b+....1.TSWU * 
8652CF74 80000000 C9D5E3D4 06324810 * EXIT.......h.A..f.....-% INTM * 
81(23E92 00000000 O6300DA0 00000000 * RELS....... er ee * 
06510928 @651C928 E3E2E6E4 06310810 * DSP .......h.A....1...1.TSWU..Q. * 
86615658 0651C928 C9D5E3D4 0631D810 * QUE........ h.A..f/....1.INT..Q. * 
86615708 80000000 E3EZE6E4 06310810 * EXIT....... HsAsct/secae TSWU..Q. * 
81C23E1A 00010000 O6300DA0 60000000 * REQS....... Hepa cSeucatases sees * 
0651C928 0651C928 C9DS5E3D4 06324810 * DSP .......h.A....1...I.INTM. * 
8652CF74 80000000 C9D5E3D4 06324810 * EXIT....... ney Eee INTM * 


06308E88 00017248 


Figure 50. Unformatted VIT Records in Dump Output (MODE=INT) 


The first line of the internal trace table is the header. (The header is not included 
in the preceding example.) The header contains the following status information: 


Byte (hex) Contents 


00-07 Zero 

08—OF Present wraparound time stamp 

10-17 Last wraparound time stamp 

18-1B Address of the most recent entry in the table 
1C-1F Address of the last entry in the table. 


Dump Analysis: Several dump analysis tools are available for the VTAM 


internal trace: 


e VITAL extracts an internal VIT from a dump for use with the VIT analysis tool. 
See “VITAL” on page 322 for a description. 


e VTBASIC displays the VIT table. See “VTBASIC” on page 326 fora 


description. 
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e VTVIT displays the VIT options that were in effect at the time of the dump and 
whether the trace was running internally, externally, or both. See “VTVIT” on 
page 340 for a description. 


Use the following procedure as an alternative to the dump analysis tools. 


Examine the internal trace table by taking a dump of VTAM with the appropriate 
storage area. Find the internal trace table in the dump by first locating the ATCVT. 
The pointer to the ATCVT (ATCLCPTR) is at low-storage location 
X'408' and J X'200'. 


If this low-storage location is not available in a dump, use the pointer in the 
MVS CVT control block extension (CVTATCVT) to find the VTAM control block 
AVT. Location hex 00 in the AVT points to the ATCVT. In the ATCVT, field 
ATCITTBL contains a pointer to the trace table. ATCITTBL is located at offset 
X'C'. The internal trace table contains a 32-byte header followed by 32-byte trace 
records. 


Recording Traces in External File (MODE=EXT) 

If you set MODE=EXT on the MODIFY TRACE command or as a TRACE start 
option, VTAM writes the VIT trace records in an external trace file. The external 
trace file contains the same information, except the first-line header record, as the 
internal trace table. 


Use external mode when you must collect large amounts of trace data, to lessen 
the chance of wraparound and lost data. However, unless you are using a tape, 
the trace data can still fill the external DASD or data file and begin overwriting itself 
if you do not ensure that the external trace file is large enough. 


Note: When you specify MODE=EXT, information is still written to the 
internal trace table for the default options. 


When recording externally, the value specified for the SIZE operand on the 
MODIFY TRACE command or the TRACE start option is used in a formula to deter- 
mine the number of 4K fixed internal buffers that can be placed in the area allo- 
cated for the trace tables. The formula is as follows: 


((SIZE x ATCPGSIZE) - 16) / 2K 


The 16 bytes that are subtracted represent the buffer header, where no data can 
be placed. 


If the SIZE operand is changed while MODE=EXT is in effect, the current table 
contents are written to the trace file before the old table is freed. 


Note: If the requested size is not available, VTAM returns to the default value of 
SIZE=50. When a low value for SIZE results in lost trace records, the lost record 
count (LRC) will be other than zero in the trace output. 


GS The external trace file is produced by GTF, and the default file name is 
SYS1.TRACE. You can print the internal trace data with IPCS or TAP. If you use 
IPCS to print the data, specify the GTFTRACE option, and set USR(FE1). For 
more information on using TAP and IPCS to print output, see “Using ACF/TAP” on 
page 361 and “Using IPCS with GTF Trace Option (MVS)” on page 362. See 
Table 80 on page 1165 to determine what books describe TAP and IPCS. 
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To produce the external trace file, use the TRSOURCE command. To format 
and print the external trace file, use the TRACERED command. Figure 51 on 
page 404 shows an example of CPTRAP output. For more information see “Col- 
lecting External Trace Data (VM)” on page 359. 


3D OE VTAM GCS USER REQUESTED GTRACE 

TIME OF DAY CLOCK = 97F6F2B3CB2BAA40 

LENGTH OF GTF HEADER AND TRACE DATA = 0030 

FORMAT ROUTINE ID = FD 

EVENT IDENTIFICATION = EFE1 
VTFR ISSR QAD1D4 AREA 00105308 SP# OQO0Q0E5 LENGTH 00000368 RC 00000000 INIT 00000000 00000000 
3D OE VTAM GCS USER REQUESTED GTRACE 

TIME OF DAY CLOCK = 97F6F2B3CEA29E00 

LENGTH OF GTF HEADER AND TRACE DATA = 0030 

FORMAT ROUTINE ID = FD 

EVENT IDENTIFICATION = EFE1 
CCI FLGS 00 ISSR O09D2EA CBID 54 SAV 106938 SVID INS1 CID 10011001 RU 00000000 00000000 00000000 
3D OE VTAM GCS USER REQUESTED GTRACE 

TIME OF DAY CLOCK = 97F6F2B3D1131C80 

LENGTH OF GTF HEADER AND TRACE DATA = 0030 

FORMAT ROUTINE ID = FD 

EVENT IDENTIFICATION = EFE1 
QUE ISSR Al289E PST 5485C008 PAB 108436D8 WG 00 ELM 104F40 PABCHN 00000000 NAME NORT 

RPH 20000000 

3D OE VTAM GCS USER REQUESTED GTRACE 

TIME OF DAY CLOCK = 97F6F2B3D3807860 

LENGTH OF GTF HEADER AND TRACE DATA = 0030 

FORMAT ROUTINE ID = FD 

EVENT IDENTIFICATION = EFE1 
FBLK ISSR A1l0EEA AREA 90104E20 ANCH 00849928 LENGTH 00000060 RC 00000000 INIT 500AA664 

00000000 


Figure 51. Formatted VTAM Internal Trace (VIT) Records in CPTRAP Output (MODE=EXT) 


[4 The external trace file is produced by TPRINT, and the default file name is 
VTAM.TRACE.FILE. To print the trace data, use TPRINT or ACF/TAP. Figure 52 
and Figure 53 on page 405 show examples of TPRINT output. For more informa- 
tion see “Using TPRINT (VSE)” on page 363. To determine the book that 
describes ACF/TAP, see Table 80 on page 1165. 


VTAM INTERNAL TRACE 85.295/18:35:54.01 LRC(62) 

VTAL . E5E3C1D3 34000000 0088C058 FFFFE5D7 60718532 00000078 00000000 00000000 VTAL..... Hives VP HE. cece wen eee 
QUE D8E4C540 340E0010 3297F010 OO980BEQ O009CDO10 00000000 DICIE3E6 90000001 QUE ..... POS Qe ace cece RATW.... 
VTAL ES5E3C1D3 34000000 0088C660 FFFFE5D7 607185B0 00000140 00000000 00000000 VTAL..... HF =. .VP-. be cece cene 
QUE D8E4C540 34490010 2497F9A8 0072BF18 O0088C660 00000000 C3C6C6C5 00000000 QUE ..... POY... HF-....CFFE.... 
VTFR ESE3C6D9 34000000 0088C058 FFFFE5D7 60718AB0 00000078 00000000 00000000 VTFR..... Hee cVPH. ccccsccvevcves 
ADSP C1C4E2D7 32000000 0097F010 00000000 00000000 00000000 80000000 O0980BEQ ADSP..... Ov tineaeweee ceases Q.. 
DSP C4C9E2D7 320E0010 0097F010 Q0980BEO 809CD010 80000000 DICIE3E6 00A31360 ODSP...... PO. Qscsecevieus RATW.T.- 
EXIT CS5E7C9E3 32000010 3297F010 O0980BEO 50A439AC 80000000 O0A43C00 00A31360 EXIT..... PQ..Q..8U....... U...T.- 


AXIT C1E7C9E3 32000000 3297F010 00000000 90000000 00000000 0000000 00000000 AXIT..... POs saaiaiewonne écmeiees 
Figure 52. Unformatted VTAM Internal Trace (VIT) Records in TPRINT Output (MODE=EXT) 
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MSG 

MSG2 
VTAL 
GBLK 


VTFR 
MSG 


WAIT 
QUE 


REQS 


VTAM TRACE FILE UTILITY 94.308 10:05:02 PAGE ] 


TID 24 SAVE 015C53B1 MSGID 3151 ISSR 815C4D3A MODID RACTI DEST SYSTEM9C TYPE S$ 
TEXT EXT200 
TID 24 AREA 011£8308 SP# FFFFD7E5 ISSR 81F9F6E6 LEN 00000150 INIT 00000000 
RC 00000000 FLAG 00 
TID 24 RC 00 ID 14 VTA 00 AREA O11AE020 ANCH 027C3088 
ISSR 81F9F994 LEN 90000098 INIT 00000000 RLEN Q000007E 
TID 24 AREA 011E8308 SP#  FFFFD7E5 ISSR 81F9FD6C LEN 00000150 INIT 00000000 
TID 24 SAVE 015C53B1 MSGID 1991 ISSR 815C4EC8 MODID RACTI DEST SYSTEM9C TYPE S 
TID 24 FLGS 21 FLGS1 00 PST  Q03FF228 PAB 00424800 ISSR 81F9AAA6 
WEQ 80000000 NAME CFR2 RPH 02799010 
TID 24 CBID OE FLGS 400400 PST 003FF118 PAB Q27C7988 ISSR 8236F72C 
WEA 02676F78 NAME RATW RPH 90000001 
TID 24 BPID LP PST 00000024 BUF 02797010 ISSR 803C55A2 BUF# 0001 


REG1 02765D90 RC 00000000 


Figure 53. Formatted VTAM Internal Trace (VIT) Records in TPRINT Output (MODE=EXT) 


Module Names in Internal Trace Records 
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Many VTAM internal trace records include the associated module names in 
EBCDIC, without the IST prefix and, for some types of trace records, without the 
sixth letter. For example, you would see TSSR for module ISTTSCSR. You can 
save time by scanning for these module names when you are following the logic 
flow through VTAM. You can sometimes isolate a VTAM problem to a specific 
component or module without even looking at a dump. 


Module names can also be determined from the ISSR field in some VIT records. If 
the issuer is an LPA module or DCSS or SVA , the address can 
be found in the VTAM module list (which currently contains LPA modules). 


The following names are exceptions to the naming convention: 


CPSS __ Session Services for CP-CP Sessions PAB 
DIIO Disk I/O PAB 

DSME Directory Services Management Exit PAB 
DSVC __sODirectory Services PAB 

LUSS _—__ Session Services for LU-LU Sessions PAB 
MSTI MST Multiple Domain Server Router PAB 
MSTR MST Multiple Domain Server Router PAB 
TRS © Topology Routing Services PAB 

XPRT _ Transaction Program PAB 


VTAM component IDs are listed in Table 31. 


ri __| Aeronym | Component Name 
reo *d Al ormitinecomponenis 
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Table 31 (Page 2 of 3). VTAM Component IDs 


> 
U 


Process scheduling services 


. APPC services 

APPN transmission group management 
Boundary function session services 
Cross domain resource manager 


CF Coupling facility services 
Ci Operator command interface 
CN Common network services 
Control operator 
SSCP System services control program functions 
Configuration services 
Data link control 
Deactivation 
Dependent LU server 
Data compression 
/DS sd Directory services 
ros ~SC«*dt (OSS ~S~CS*diéC at apace sence 


manager 
[lew _[svscen | syetomgenerten id 
c 


LM TPFLOGON Transaction processing facility (TPF) logon 
manager 


Di pi >Db 


ws) 


2/R 
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= 
Zz 
> 
= 


Table 31 (Page 3 of 3). VTAM Component IDs 
Component Name 


G Messages 


” 
— 


5 
<< 
oP) 


= 
a | 


Zz 
r 
ws) 


Management services transport 
Network address management 


Network logical data manager 


= 
1@) 


Network operator services 


ma) 


Network resource management 
LU network services 
Open/Close ACB 

VTAM OSI RPI 


| SMS ss Storage management services 


ee 
Cam | RM _—_*| Wesourcos manager 


SA SYS-ATTC System attach 


Q]|” 
O;F£ 
S| 


OTS i 


Session services CP-CP 


2) 
ew 


TTT 


SYSDEF 
SSL Session services LU-LU 
SSCPSS | 
TSC-BSC 
TSC-DLC 
TSC-LAN 
TSO/VTAM 


System definition 


op) 

2) 

” 

” 
i 


a 


Session services 


a |e 


TSC Binary Synchronous Communication 
TSC-DLC 

Token Ring Local Area Network 
TSO/VTAM 


Topology routing services 


s 


TO fis 


a 


S 
TSX-X25 
S 


O 


~ 
mt) 
8) 
” 


Transmission subsystem 
X.25 

Unformatted session services 
VI VSAM I/O 


VIO 


o 
7) 
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SNAP Trace Record 


Besides recording the previously mentioned functions, you can use the VIT to 
record 32, 64, 96, or 128 bytes of user-generated information in a SNAP trace. 
This SNAP trace can place additional information into a VTAM module that might 
be useful in resolving a VTAM problem. The VIT traces the specified bytes and 
enters the data as a SNAP trace entry in the internal trace table or in the external 
trace file. 


Unlike other trace entries, you do not specify the SNAP trace as an option of the 
MODIFY command. Instead, your code must follow these steps: 


1. Verify that the pointer to the ATCVT (ATCLCPTR) is not 0. ATCLCPTR is at 
low-storage location X'408' or [JJ X'200'. 


2. Verify that ATCRACTR is not 0. 


3. Call the internal trace recording routine (ISTRACTR) in a VTAM module. Field 
ATCRACTR in the ATCVT points to the trace recording routine. For the hex 
offset, see VTAM Data Areas for MVS/ESA, VTAM Data Areas for VWESA, or 
VTAM Data Areas for VSE/ESA. 


Note: SNAP records cannot be taken during the early stages of VTAM initializa- 
tion, nor can they be taken during the late stages of termination. 


The SNAP trace requires the following information in registers 1, 14, and 15 on 
entry to the trace routine: 


Register 1 
Points to the 32, 64, 96, or 128 bytes to be recorded. 


Register 14 
Points to a 2-byte input flag field containing: 


e Hex 141C for a 32-byte SNAP entry 
e Hex 142C for a 64-byte SNAP entry 
e Hex 143C for a 96-byte SNAP entry 
e Hex 144C for a 128-byte SNAP entry. 


These flags tell the trace recording routine to record a SNAP trace. 


Two Bytes Past the Address in Register 14 | 
Is the address returned to after recording a SNAP trace. 


Register 15 
Points to the SNAP trace recording routine (ISTRACTR). 


When the trace recording routine returns control to the calling module, the contents 
of registers 6 and 7 are unpredictable. The contents of the other registers, 
however, are not changed. 


The SNAP trace record is unformatted. You should format the first 4 bytes of the 


SNAP record for a 1- to 4-character EBCDIC record identifier (for example, 
C'ABCD'). 
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Notes: 


1. The 1- to 4-character EBCDIC record identifier should not match any existing 
VIT record identifier. 


2. For the VIT snap entry to be used by the VIT analysis tool, the VIT entry name 
must be the first 2 to 4 characters of the VIT entry. 
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Deactivating the VTAM Internal Trace 


You can stop one or more of the active VIT options by issuing the MODIFY 
NOTRACE command with TYPE=VTAM specified. You can specify which traces 
are to be stopped using the OPTION operand. 


If you specify OPTION=ALL, all active user selected VIT options are stopped, but 
the internal trace table is not freed. If you are only recording externally, a new 
internal trace table is started when this command is issued. Exceptions and default 
options are still recorded during this idle period. | 


If you specify OPTION=END, all active user selected internal VIT options are 
stopped, and the internal trace table is freed. The internal trace table is reallocated 
to 50 pages for the default options. 


If you specify MODIFY NOTRACE, TYPE=VTAM, MODEsSINT, internal trace 
recording is stopped. If you specify MODIFY NOTRACE, TYPE=VTAM, 
MODE=EXT, external tracing recording is stopped. If you do not specify MODE, all 
options are stopped, but the default options are immediately restarted and recorded 
internally. 


If you attempt to stop the VIT using MODIFY NOTRACE, OPTION=END and the 
termination hangs, you can issue MODIFY NOTRACE, OPTION=FORCE to stop 
the VIT. If you issue MODIFY NOTRACE, OPTION=FORCE but the VIT is not 
waiting to terminate, VTAM issues message IST1038! stating that the NOTRACE 
command has been rejected because the VIT is not in the waiting (to terminate) 
state. 


For more information see “MODIFY TRACE Command,” “MODIFY NOTRACE 
Command,” and “START Command (MVS, VM)” in VITAM Operation. 
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Chapter 10. Using the VIT Analysis Tool (MVS, VM) 


This chapter describes the following: 


“Setting up and Running the VIT Analysis Tool” 
“Analyzing Storage” on page 417 

“Counting Request/Response Units (RUs)” on page 426 
“Extracting Information from the VIT” on page 434 
“Using the Timing Options” on page 442 

“Using the I/O Options” on page 445 

“Creating Your Own Parameter Dataset” on page 447. 


You can use the VIT analysis tool to obtain information about a VTAM internal trace 
(VIT) that you have recorded on or transferred to an external device. The tool pro- 
vides the following functions: 


e Storage analysis 
e Request and response unit (RU) counting 
e VIT extraction. 


You can choose to process only the VIT records that fall within a given time range 
in the trace record. In addition you can choose to: 


e Add a title and a short description to the first page of each report 
e Format the output 
e Create a mini-report at a specified interval. 


For information on required target data sets for the tool, see “Installing the VTAM 
Dump Analysis Enhancements and the VIT Analysis Tool” in the VTAM Network 
Implementation Guide. \f you want a customized interface to be active to select the 
trace analysis commands of the VTAM program, see “Customizing the IPCS 
Interface” in the VTAM Network Implementation Guide for information. 


If you experience problems that you suspect to be related to the VIT analysis tool, 
see “VTAM Internal Trace (VIT) Analysis Tool Problems (MVS) (VM)” on page 42 
for help. 


Setting up and Running the VIT Analysis Tool 
Do these steps to set up and run the tool: 


1. Record a VIT on an external device or transfer a previously recorded VIT to an 
external device. 


. Set up to run the tool. 

. Create the parameters for the job. 
. Run the job. 

. Check the output. 


a fF W WN 


The following sections describe each step. 
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Step 1. Record a VIT 


You must have a VIT on an external device, such as a disk or a tape before you 
can use the tool. 


A VIT that has been internally recorded can be copied to an external device 
using the VTAMMAP VITAL function. For instructions on the VTAMMAP VITAL 
_ function, see “VITAL” on page 322. 


Convert the TRSOURCE trfile to a “GTF-like” CMS file, using the following 
command: 


TRACERED NAME traceid GTRACE 


traceid is the collection of TRF files and is the same value as is specified in the 
TRSAVE and TRSOURCE commands. traceid will cause TRACERED to process 
all of the TRF files at once, producing a consolidated output file in chronoiogical 
order. See Table 80 on page 1165 to determine what book contains more infor- 
mation on TRACERED. 


Step 2. Set up to Run the Tool 


Create a Data Set (MVS) 
Create a data set specifying the input and output data sets and the tool's program 
name. You may use JCL, a CLIST, or a REXX exec to create your data set. 


Batch Mode: Use the sample JCL shown in Figure 54. Lower case indicates 
required variable information. The actual JCL is determined by your 
installation. For example, A has been defined as a printer in the sample installa- 
tion, and SYSOUT=A directs output to it. Similarly, the sample JCL assumes that 
all input datasets have been catalogued. 


Modify the JCL by including appropriate DD names. Even though all DD names 
shown are not required for all runs, you might want to list them to avoid changing 
your JCL when you change parameters. The record format for the output data sets 
can be variable or variable blocked (RECFM=V or RECFM=VB). 


//jobname JOB (account),'user name',etc. 
//ISTRAFT1 EXEC PGM=ISTRAFT1, REGION=0K 
//STEPLIB DD DSN=SYS1.SISTDBUG,DISP=SHR 
//SUMMARY DD SYSOUT=A,DCB=(RECFM=V, LRECL=84) 
//DETAILS DD SYSOUT=A,DCB=(RECFM=V,LRECL=84) 
//LOG DD SYSOUT=A, DCB=(RECFM=V, LRECL=124) 
//OUTSTAN DD SYSOUT=A, DCB=(RECFM=V, LRECL=124) 
//VITEXT DD SYSOUT=A,DCB=(RECFM=V, LRECL=124) 
//PARM DD DSN=userid.runl.parm, DISP=SHR 
//TRACE DD DSN=userid.runl.trace, DISP=SHR 


Figure 54. Sample JCL for VIT Analysis 


As shown in Figure 54, the JCL contains the following DD names: 


e SUMMARY is required and specifies where the output summarizing the trace is 
directed. 


¢ DETAILS is required only for storage analysis and RU counting. It specifies 
where details of the trace analysis are directed. 
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e LOG is required. It specifies where VIT entries with possible errors are 
directed. 


e OUTSTAN is required only for storage analysis of outstanding entries. It speci- 
fies where the list of outstanding GBLK, VTAL, and REQS entries is directed. 


e VITEXT is required only for VIT extraction. It specifies where the VIT entries 
extracted from the trace are directed. 


Note: Only the FORMAT and NOFORMAT output options should be used 
when directing VITEXT output to a printer as shown in Figure 54 on 
page 412. VITEXT output using TRACEFORMAT should be directed to 
disk or tape. 


For VITEXT output using TRACEFORMAT, the record length must be the 
length of the TRACE record or 284, whichever is smaller. 


e PARM is required and specifies the parameters to be passed to the VIT anal- 
ysis tool. Parameters can be specified in-stream (in the JCL) or in a dataset; 
do not use the PARM parameter on the EXEC statement for this purpose 
because of size restrictions. The PARM dataset must have fixed records (can 
be blocked) with: 


— LRECL=80 
— RECFM=FB 


e TRACE is required and specifies the input dataset containing the trace to be 
processed. The TRACE DCB information must match the actual data set char- 
acteristics. The record format can be V, VB, or VBA. 


Interactive Mode: As an alternative to running in batch mode, you may invoke the 


following routine to run the VIT analysis tool interactively. If you choose this 
method for processing, your terminal will be unavailable until processing is com- 


RRR RIKRI RIKI KERR KREINER IIASA IAAI EIA IIIS AREER AIAIAKERE | 


pleted. 

1. /*REXX*/ 

2 . [RRR IIK EIA ERR EIA EERIE AAA IAAERIER REE | 
3. /x Run the VIT analysis tool interactively. x/ 
4, /* */ 
5. /x Tailor the data set names and other ALLOC options as needed for«/ 
6. /* each run. x/ 
7. /[* */ 
8 

9. 


10.'ALLOC DD(PARM) DSN(runl.parm) SHR' 
11. 'ALLOC DD(TRACE) DSN(runl.trace) SHR' 
12.'ALLOC DD(SUMMARY) DSN(runl.summary) OLD' 
13.'ALLOC DD(DETAILS) DSN(runl.details) OLD' 
14.'ALLOC DD(OUTSTAN) DSN(runl.outstan) OLD' 


15.'ALLOC DD(LOG) DSN(runl.10g) OLD’ 
16.'ALLOC DD(VITEXT) ODSN(runl.vitext) OLD' 
17. 

18."CALL 'SYS1.SISTDBUG(ISTRAFT1) '" 

19. 


20.'FREE DD(SUMMARY,DETAILS ,OUTSTAN, LOG, VITEXT, PARM, TRACE) ' 
Figure 55. Sample VIT Analysis Tool Interactive Routine 


The lines in Figure 55 are: 
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Description 

Required for a REXX EXEC 

Comments 

Data set allocations. The data sets must be pre-allocated. 


Invokes the VIT analysis tool, assuming that it has been installed in the 
SYS1.SISTDBUG load library. 


Frees the datasets allocated to the DD name statements to allow the exec 
to run again with different data set names. 


Note: The DD parameters are required. The DSN parameters are optional and 


can be varied. 


Warning 


1. Return codes are not checked in this example. 

2. Your user terminal will not be available while the tool is active. 

3. This example is not shipped with the VTAM code and is included for infor- 
mation only. 


Issue the appropriate FILEDEFs (VM) 


Issue the FILEDEFs from the command line or use the sample REXX exec shown 


in Figure 56. 


Note: MVS GIF trace tapes can be processed on VM as long as the VTAM trace 
records are generated from an MVS-equivalent VTAM. 


~ /* REXX */ 


‘GLOBAL LOADLIB ISTDEBUG' 


/* Define ISTRAFT1 for OSRUN x/ 


‘ [RHEE REE RR EKER EERIE IIIS AIHA IIIB ERIS IA IAIEREREERITKE | 


1 

2 

3 

4, /* Define DD names. 

5. [RRR ARIK EERE EERE REIKI IIIA AIS SIA III II ARAKI IIIS IAI AAKEEEEEEE | 
6 "FILEDEF PARM 

7 'FILEDEF SUMMARY 

8. 'FILEDEF DETAILS 

9.  ‘'FILEDEF OUTSTAN 


*/ 


DISK INPUT 
DISK SUMMARY 
DISK DETAILS 


PARM A (PERM RECFM F LRECL 80' 
OUT 
OUT 


A (PERM RECFM V LRECL 84' 
A (PERM RECFM V LRECL 84' 


DISK OUTSTAN OUT A (PERM RECFM V LRECL 130' 
10. ‘FILEDEF LOG DISK LOG OUT A (PERM RECFM V LRECL 124' 
11. ‘FILEDEF VITEXT DISK VITEXT OUT A (PERM RECFM V LRECL 32756' 
12. '‘FILEDEF TRACE DISK TRACEDAT GTOUT A (PERM RECFM V_ LRECL 284' 


Figure 56. Sample REXX Exec for VIT Analysis Tool 


- The lines in Figure 56 are: 


Line 


3-5 
6-12 


Warning 


Description 

Required for a REXX EXEC 

Set up the loadlib containing ISTRAFT1. 
Comments 


CMS file definitions. For a description see page 412. 


1. Return codes are not checked in this example. 
2. This example is not shipped with the VTAM code and is included for infor- 
mation only. 
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Step 3. Create the Parameters for the Job 
To create the parameters needed to analyze your VIT: 
1. Use the panel interface. On the VTAM Internal Trace Analysis panel, specify 
the form of processing you want to use. Only one function may be used ina 


session. The panel interface then provides choices and help in specifying 
values for the parameters, and creates the PARM dataset. 


Pick option 1, 2, or, 3 from the Figure 57 ISTTO001 and follow the processing 
path until you return to the panel ISTT0001. Then choose option 4 to indicate 
that your input has been completed. | 


ISTTO001 VTAM Internal Trace Analysis 


Select a choice, then press Enter. 


__ 1. Storage Analysis 
2. Request/response unit counting 
3. 
4, 


VIT extraction 
Input Complete 


(C) Copyright IBM Corporation 1994. All rights reserved. 
Command ===> 


Figure 57. VTAM Internal Trace Analysis Option Panel 
Note: If an incorrect value is entered in a field, the cursor appears on the field 
where the error was made. For help about that field, press F1. 
2. Use an editor to either: 
e Create a parameter data set 
° Code the parameters in-stream in the JCL created in step 2. 


See the parameter syntax for a particular function, and “Creating Your Own 
Parameter Dataset” on page 447 for further details. 


See “How to Read the Syntax Diagrams” on page 238 for general information 
on how to code and read syntax diagrams. 


Step 4. Run the Job 


Submit the dataset for processing that you created in step 2. You may process it in 
batch mode or interactively. 

Issue the command 

OSRUN ISTRAFT1 


to invoke the VIT analysis tool, which should have previously been installed in the 
ISTDEBUG load library. 
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Step 5. Check the Output 


After processing is complete, check the following data sets for your results: 


For RU counting and storage analysis reports, check the DETAILS data set 
For the extracted VIT entries, check the VITEXT data set 
For unmatched storage allocation entries, check the OUTSTAN data set. 


If you do not get the expected output, check the SUMMARY and LOG datasets for 
error messages or other information on what might have caused the problem. For 
example, the SUMMARY dataset contains the parameters used for the job, 
including the parameters specified and the defaults taken. 


If the trace has wrapped, indicate this on the I/O Options panel or use the WRAP 
parameter. If the GTF trace tapes were specified in the wrong order, correct the 
order of the tapes in the JCL. In either case, submit the job again. 


Return codes 3 
If an error has occurred and the SUMMARY data set is available, a message will 
be written in the data set. The return codes are: 


0 No errors found 
4 Counter overflow - processing continues, if possible . 
8 Storage unavailable - processing continues, if possible 
10 1/0 failure - processing continues, if possible 
12 Unrecoverable error - processing stops 
Environment e The VTAM V4 formatted trace and the VIT analysis tool cannot process data 


created by earlier VTAM releases because of changes to output formats. 


e Because of the way that GTF and TRSOURCE handles entries that 
continue to multiple records, VTAM can only assume that the continued records 
are contiguous, and matching the continuation record to the prior record cannot 
be guaranteed. 


e lf you get trace information that is out of sequence, the trace may have wrapped. 
If the trace wrapped when it was recorded, specify WRAP on the VIT analysis 
tool. 


e The existing VTAM formatted trace provides trace record formatting by splitting 
up all VIT entries into logical pieces and adding labels to indicate what the data 
represents. This function will not be replaced, and you can still format the VIT 
using the IPCS subcommands VERBEXIT VTAMMAP or GTFTRACE and 
TRACERED . 
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Analyzing Storage 
Use storage analysis to count storage allocated and freed, match related SMS 
entries, and report potential storage concerns found in a VIT. The main panel for 
storage analysis is shown in Figure 58. Select an option and follow the prompts. 


ISTTOO6A Storage Analysis - Panel 1 of 3 


Select. Then press Enter. 


Matching . Match allocates, frees 
None 


Unmatched allocates 2 . List unmatched entries 
Do not list entries 


Storage lengths .. . List storage lengths 
Do not list lengths 


Figure 58. VTAM Storage Analysis Option Panel 


Matching 

You can choose to match allocate entries with free entries. Depending upon which 
areas of storage are selected on subsequent panels, some or all of the following 
VIT entries are matched: 


_¢ GBLK and FBLK 
e VTAL and VTFR 
e REQS and QREQ 
e REQS and RELS 
e REQS and AREL. 


The default is no matching. 


Unmatched Allocates 

You can choose to list all unmatched (outstanding) storage allocates found. By 
default, they are ignored. There may be a large number of unmatched storage 
allocates and the output may be very long. Unmatched allocates can occur if the 
VIT is not complete. Entries listed are not necessarily error conditions. 


Storage Lengths 


You can choose to list the storage lengths (number of bytes or buffers) requested, 
allocated, and freed. By default, storage lengths are not listed. 
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GBLK Pools, VTAL Pools, and REQS Buffer Pools 

You can designate which SMS VIT entries to process. By default, all GBLK pools, 
VTAL pools, and REQS buffer pools are processed. Choices are available to 
process some or none of these pools. If you choose to process some, a panel is 
displayed from which you can choose the specific pools to process. For GBLK and 
VTAL, your choices include listing only the storage pools allocated from private 
storage or only the storage pools allocated from CSA (by default, both private and 
CSA storage pools are listed). 


Address Space Identifiers (ASIDs) and Data Spaces 

You can limit storage analysis to specific ASIDs ({{[{J machine IDs and task IDs) 
and data spaces. By default, all ASIDs and data spaces are processed. If one or 
more ASIDs or data spaces are specified, only SMS entries associated with each of 
the specified ASIDs or data spaces are processed. 


Note: Data spaces only apply to GBLK entries. 


Parameter Syntax 

Use the following syntax only if you are using an editor to write your parameters as 
an alternative to the panel interface. See “How to Read the Syntax Diagrams” on 
page 238. 
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SMS 


i SMS (GBLK(CSA) ) os 


SMS (GBLK(PVT) ) 


SMS (GBLK(—¥poo1_number-) ) 


SMS (VTAL (CSA) ) 
SMS (VTAL (PVT) ) 


SMS (VTAL (~¥p00l_number-Lt8\—) ) 
SMS (REQS) 


SMS (REQS (-*bufname_-) ) 
L swscmatcu)— L sws(veneths). | sms(oursTANDING)— 


[ ee ee i SMS (DSNAME oc ae 


Notes: 
' Coding SMS has the same effect as coding 
SMS(GBLK) SMS(VTAL) SMS(REQS) 


2 You can code one or more from each choice group below. 


Coding SMS(GBLK) has the same effect as coding 
SMS(GBLK(PVT)) SMS(GBLK(CSA)) 


4 You can code one or more from each choice group below. 


5 Code one or more pool_numbers in the range 0-255. Separate each 
pool_number from the next with a comma. 


Coding SMS(VTAL) has the same effect as coding 
SMS(VTAL(PVT)) SMS(VTAL(CSA)) 


7 You can code one or more from each choice group below. 


8 Replace the two xs with two hex characters. You can code up to 5 ASIDs 
( {7M machine IDs and task IDs) . 


Replace the eight cs with eight alphanumeric characters. You can code up 
to five DSNAMEs. 


10 Data is not case sensitive. 


Oo 


o> 


© 


Sample Output for Storage Analysis 
In this example, the following PARM file was submitted: 


sms sms(lengths) sms(match) sms(outstanding) 
stoptime(02:04:10) noformat 
DESC This example shows storage analysis with a stop time. 


The resulting Summary, Detailed, and Outstanding data sets follow. 
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Notes: 
1. Ellipses indicate that part of the output has been omitted. 
2. STOPTIME is described in “Using the Timing Options” on page 442. 
3. NOFORMAT and DESC are described in “Using the I/O Options” on page 445. 


4. General parameter coding information is described in “Creating Your Own 
Parameter Dataset” on page 447. 


The following is an example of a Summary report for storage analysis, which is 
written to the data set name that you specify to receive the report. The DD name 
for the data set must be SUMMARY. The first line of all reports shows the VTAM 
level, the 20-character title (the default is "Trace Analysis "), and the date that 
the report was processed. The description, if specified, follows the title. 


The next several lines of the report are the specified parameters and the defaults. 

These are followed by observations which are included to highlight important prop- 
erties of the trace that were encountered during processing. The observations will 
vary depending on the trace content and the options specified. The option choices 
are storage analysis, RU counting, and VIT extraction. 


The trace statistics section contains the first and last time stamps, the record type 
count, the VIT entry count, and the VIT option count. For example, there may be 6 
PIU VIT entries and 18 PIU2 entries, for a total of 24 PIU VIT option occurrences. 
Some VIT entries are not associated with a VIT option. If entries of this type are 
found, the total is listed beside "N/A" in the VIT option counts. If SNAP entries are 
found, the total is listed beside "?" in the VIT option counts. 


VTAM V4 Trace Analysis Summary 92.325 11/20 11:28:47 LOC 


This example shows storage analysis with a stop time. 


Wrapped: No 
Formatting: No 
Interval: None 


Start time: Beginning of trace 
Stop time: 91.199 07/18 02:04:10.000 LOC (A43572C3 51A80000) 


SMS : Yes 
ASIDs: All 
Options: MATCH LENGTHS OUTSTANDING 
GBLK: All 


VTAL All 
REQS: All 
RU: No 
VITEXT: No 


KEKKKKKKKKKKKK KKK KKK KKK KEKE KKK KKK KKK KKK KKK RK RR RK KK 
Observations 


Only 27 GBLK entries were found in this VIT. The findings should be verified 
on a larger trace. 


Only 7 VTAL entries were found in this VIT. The findings should be verified on 
a larger trace. 


The high water mark is 392 bytes allocated by VTAL. This occurred at 
02:04:07.715 LOC (record 115). 


Only 18 REQS entries were found in this VIT. The findings should be verified 
on a larger trace. 
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KKKKKKKKK KKK RRR RK KKK KKK KKK KKK RRR RK KK KKK 
Trace Statistics 


First GIF Timestamp: 91.199 07/18 02:03:13.266 LOC (A435728D 36BFAEQ1) 
First VIT Timestamp: 91.199 07/18 02:03:13.266 LOC (A435728D 36BFAEQ1) 


Last VIT Timestamp: 91.199 07/18 02:04:07.716 LOC (A43572C1 24007002) 
Last GIF Timestamp: 91.199 07/18 02:04:10.866 LOC (A43572C4 2529DC02) 


Summary of GTF Record Types 


1 Timestamp control records 
116 VIT records 


117 Total GTF records 
Count of VIT Entry and Option Occurrences 


VIT Entry Occurrences 


33 FBLK 27 GBLK 
6 PIU 18 PIU2 
19 RELS 18 REQS 
7 VTAL 5 VTFR 

VIT Option Occurrences 

24 PIU 

109 SMS 

133 Total 


The following is an example of a Detailed Report for storage analysis, which is 
written to the data set name that you specify to receive the report. The DD name 
for the data set must be DETAILS. In this example, the GBLK pool totals follow the 
title and description. The totals are listed first for each get block (GBLK) pool in the 
"Home" data space, then for each pool in other data spaces, if any exist. For each 
pool, the pool number is shown in decimal and hexadecimal, followed by the pool 
name, an indication of allocation from private storage or CSA, and the data space 
name. 


Following the counts of total entries, matches, bytes allocated and freed, and other 
entries, you will find a summary number for the allocate and freed entries in this 
pool for each storage size. This section only written if the LENGTHS option is 
specified. In this example, there were 9 GBLK entries, each of which allocated 152 
bytes and requested 152 bytes. The largest number of GBLK entries not matched 
to a free block (FBLK) at one time was 5. There were 9 FBLK entries, each of 
which freed 152 bytes. 


Following the GBLK pool counts for each pool are the totals for all GBLK pools. 


Next, the VTAL pools are listed like the GBLK pools and finally the REQS are 
listed. 
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VTAM V4 Trace Analysis Detailed Report 92.194 07/12 18:51:44 LOC 
This example shows storage analysis with a stop time. 

GBLK Pool Totals: 

Home Data Space: 


GBLK Pool © (X'00'): RUPEPRIV (Private) Data space: Home 
GBLK entries (including failures, if any) 
FBLK entries (including failures, if any) 
GBLK and FBLK matches 
Largest number of GBLK entries at one time 
1,368 Bytes allocated 
1,368 Bytes allocated above the 16M line 
1,368 Bytes requested 
1,368 Bytes requested above the 16M line 
1,368 Bytes freed 
1,368 Bytes freed above the 16M line 
608 Bytes not freed 
760 Most unfreed bytes 


mom Wo wo 


Bytes Bytes GBLK Maximum FBLK 
Allocated Requested Entries Requested Entries 
152 152 9 5 9 


GBLK Totals: 
27 GBLK entries (including failures, if any) 
33 FBLK entries (including failures, if any) 
16 GBLK and FBLK matches 
13 Largest number of GBLK entries at one time 
5 Largest number of GBLK entries at one time in one pool 
was in pool 0 (X'00') in Home data space 
4,192 Bytes allocated 
3,696 Bytes allocated in private storage 
496 Bytes allocated in CSA 
4,192 Bytes allocated above the 16M line 
3,375 Bytes requested 
2,888 Bytes requested in private storage 
487 Bytes requested in CSA 
3,375 Bytes requested above the 16M line 
3,672 Bytes freed 
3,304 Bytes freed in private storage 
368 Bytes freed in CSA 
3,672 Bytes freed above the 16M line 
2,160 Bytes not freed 
1,880 Bytes not freed in private storage 
280 Bytes not freed in CSA 
2,824 Most unfreed bytes 
was at 02:04:07.715 LOC at record 116 
1,536 Most unfreed bytes in one pool 
was in pool 32 (X'20') in Home data space 


HREAEKKKEKRKEEEKEREEKEEKEREEEEKEEEKKEEREKRKKEE 
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VTAL Subpool Totals: 


Subpool 13 (X'OD'): Private 

3 VTAL entries (including failures, if any) 
2 VTFR entries (including failures, if any) 
2 VTAL and VTFR matches 
1 Largest number of VTAL entries at one time 

288 Bytes allocated 

288 Bytes allocated above the 16M line 

192 Bytes freed 

192 Bytes freed above the 16M line 

96 Bytes not freed 

96 Most unfreed bytes 


Bytes VTAL Most VTAL VTFR 
Allocated Entries Entries Entries 
96 3 1 2 


VTAL Totals: 
7 VTAL entries (including failures, if any) 
5 VIFR entries (including failures, if any) 
5 VTAL and VTFR matches | 
2 Largest number of VTAL entries at one time 
1 Largest number of VTAL entries at one time in one pool 
was in pool 13 (X'QD') 
1,344 Bytes allocated 
768 Bytes allocated in private storage 
576 Bytes allocated in CSA 
1,344 Bytes allocated above the 16M line 
952 Bytes freed 
672 Bytes freed in private storage 
280 Bytes freed in CSA 
952 Bytes freed above the 16M line 
392 Bytes not freed 
96 Bytes not freed in private storage 
296 Bytes not freed in CSA 
392 Most unfreed bytes 
was at 02:04:07.715 LOC at record 115 
368 Most unfreed bytes in private 
296 Most unfreed bytes in CSA 
368 Most unfreed bytes in one pool 
was in pool 47 (X'2F') 


KREREKEKAEKKEKKEEKEREKRERERERERERKEKRREKEKEER 
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REQS Totals by Buffer Pool: 


REQS Buffer Pool IOBUF 


Buffers 
Buffers 
Buffers 
Buffers 
Buffers 
Largest 


Nr PH pw wo 


Buffers per 
Request 
1 


REQS Totals: 


Buffers 
Buffers 
Buffers 
Buffers 
3 Buffers 
5 Largest 


REQS 
Entries 


“Restricted Materials of IBM” 
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REQS entries (including failures, if any) 
RELS entries (including failures, if any) 
RELS entries were matched 


allocated 

allocated above the 16M line 
freed ; | 

freed above the 16M line 

not freed 

number of buffers at one time 


Most REQS 
Entries 
2 


REQS entries (including failures, if any) 
RELS entries (including failures, if any) 
RELS entries were matched 


allocated 

allocated above the 16M line 
freed 

freed above the 16M line 

not freed 

number of buffers at one time 


was at 02:03:44.609 LOC at record 71 
3 Largest number of buffers at one time in one pool 
was in the LPBUF pool 


The following is an example of an Outstanding Report for storage analysis, which is 
written to the data set name that you specify to receive the report. The DD name 
for the data set must be OUTSTAN. Following the title and description, the 
unmatched GBLK entries are listed by pool number for each data space. Next the 
unmatched VTAL entries are listed by subpool number then the unmatched REQS 
and REQ2 entries are listed by buffer name. 


Notes: 


1. The REQ2 entries consist of the VIT entry name (REQ2) followed by 1 to 7 
addresses. Instead of showing the actual REQ2 entry, which does not contain 
the data shown on the REQS eniry, each buffer address is shown as if it had 
appeared in a REQS entry. 


. The queued REQS entries which have not been matched by a QREQ entry are 


also listed in the OUTSTAN data set. These REQS have a buffer address of 


zero. 
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VTAM V4 Trace Analysis Outstanding Report 92.194 07/12 18:51:44 LOC 


This example shows storage analysis with a stop time. 
KEKKKKKEKKEKEKEKEKEKEKKKEKEKKEKEREKKEKEEKEEKEEKERERKKEEKEEREKEKAEKEAKEKEKREKKKEEKEKKK 


* List of outstanding GBLK entries * 


KAEKKEKKKKEKKKEKEEEEKKREKEREKREKEEREKRKEKREEKREKEKEEREEKREKEEEREKEEEREKEKEEEREKKEEKEKEKER 


Home Data Space: 
GBLK Pool © (X'00'): RUPEPRIV (Private) Data space: Home 


Outstanding GBLK at 02:03:52.888 LOC (record 89) 
C7C2D3D2 OCO000000 06638480 06357218 823D6340 00000098 864EBCF8 00000098 *GBLK...... Gauss Dest aa qf+.8...q* 


Outstanding GBLK at 02:04:01.276 LOC (record 102) 
C7C2D3D2 OCO00000 066388E0 06357218 82306340 00000098 864EBCF8 00000098 *GBLK...... A\wsa Deas ars qf+.8...q* 


Outstanding GBLK at 02:04:01.276 LOC (record 105) 
C7C2D3D2 OC000000 066385CO 06357218 82306340 00000098 8644B2B8 00000098 *GBLK...... G: s5430ce Sea OT exsdes qx 


Outstanding GBLK at 02:04:03.374 LOC (record 108) 
C7C2D3D2 OCO00000 06638340 06357218 823D6340 00000098 864EBCF8 00000098 *GBLK...... CO iseDew: dacs qf+.8...q* 


e 
CELT TTLCLT CELL CTL T TT CL TCCCLTCICCTCCLCLCTOCICCLCTCCCTCCLCCCLCCTCCCLCLSCCLLOCSC TCL LOL LT SL Le eT 


* List of outstanding VTAL entries * 
KEKKEKEKEKKREKEKEKEKRAEKEKKEKEKKKEKEKEREKKAEKKKEEERKEKEKEREEKKEKREREKEREKRK KR RKEKK 


Subpool 13 (X'QD'): Private 


Outstanding VTAL at 02:04:05.615 LOC (record 112) 
E5E3C1D3 OCO00000 067A3FAO O000000D 82478930 00000060 80000000 OQO00000 *VTAL..... So owas D.i.ssereee 


Subpool 15 (X'OF'): Private 
Every valid VTAL in this pool was matched by a VTFR. 


KKEKEKKKEKKEKKEKKEEKEKKEEKEEKEEKEEEEKEEEEKEEEREKEKEEEKKKEEKEREKERKEEKEREEREKEKKK RR: 
* List of outstanding REQS entries * 
* (Note: Each buffer from a REQ2 entry is listed as a separate REQS) * 


KEEREKKKRERKREKREKREEEEEEREEKREREREKREEKEREEEKEERERKEEREKRERERKEEREKEREREEEEKEREREREREREE 


REQS Buffer Pool IOBUF 


REQS waiting for QREQ or RELS at 02:03:25.703 LOC (record 35) 
DICSD8E2 OCQO0000 O6Z2EAE88 06321010 823B95F4 00010000 062DD648 00000000 *REQS....... Nese Delt. seaae aera * 
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Counting Request/Response Units (RUs) 
Use RU counting to list the number of each kind of RU found in a PIU. Because 
there are so many RUs, RU counting lets you specify which RUs you are interested 
in. The main panel for counting request/response units is shown in Figure 59. 
Select an option and follow the prompts. 


ISTTO10A Request/Response Unit Counting 


Select, then press Enter. 


Requests/Responses 3 1. Request units only 
2. Response units only 
3. Both 


All 

Some - type codes 
Some - list names 
Some - list codes 


Network addresses . All 
From and/or to one address 
Between two addresses 
From one address to another 


Sort order .... 1. Name 
2. Frequency 


Figure 59. VTAM Request/Response Unit Counting 


Requests/Responses 
You can choose to process only request units, only response units, or both. Both 
are processed by default. 


RUs 

You can choose to process only specific RUs. Subsequent panels allow you to 
specify particular RUs by typing the codes, by picking the RUs from a list of RUs by 
name, or by picking the RUs from a list of RUs by code. By default, all RUs are 
processed. 


Network Addresses 

You can also specify processing of all PiUs found in the VIT regardless of the 
origin and destination, only PlUs from one network address to another in a single 
direction, all PIUs between two network addresses in both directions, or all PIUs to 
and from one network address. 


Sorting Order 


You can sort the RU counts either alphabetically (by RU name) or by frequency (in 
descending order of counts). The default is sorting by RU name. 
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RU 


Notes: 


Parameter Syntax 

Use the following syntax only if you are using an editor to write your parameters as 
an alternative to the panel interface. See “How to Read the Syntax Diagrams” on 
page 238. 


RU(AMRU(—Yamru_codeLl2)_) ) 

RU(DFC(¥dfc_codeL{)-) ) 

RU (FMD (—¥fmd_code/!4)-) ) 

RU (FROM(suborea_numbe — ) 
element_number 


RU(FROMTO(subarea_number , subareo_number 76). ) 
= lement_numbe Ss ,element_number 
RU(NC(—¥nc_code/16)_) ) 


RU (REQ) 
RU (RESP) 


RU(SC(—¥s¢_codeL{Z_-) ) 


RU (SORT (FREQ) ) 
RU (SORT (NAME) ) 


RU(T0(subarea_number—>———--—-{8)_) 
,element_number 
RU(—¥ru_codel{al_) 


1 You can code one or more of these options. Unless otherwise noted, code each option no more than 


once. 


2 Each amru_code is four or eight hex characters. You can code up to 32 amru_codes. 

3 Each dfc_code is two or four hex characters. You can code up to 32 dfc_codes. 

4 Each fmd_code is six or eight hex characters. You can code up to 32 fmd_codes. 

5 Each subarea_number is eight hex characters, and each element number is four hex characters. 
6 Each nc_code is two or four hex characters. You can code up to 32 nc_codes. 

7 Each sc_code is two or four hex characters. You can code up to 32 sc_codes. 

8 Each ru_code is two, four, six, or eight hex characters. You can code up to 32 ru_codes. 

® Data is not case sensitive. 


RU Parameter Coding 
RU means count all request/response unit codes. 


RU(NC(...)), RU(SC(...)), RU(DFC(...)), RU(FMD(...)), or RU(AMRU(...)) means 
count only the RUs in categories which have the specified codes as follows: 
e NC, SC, and DFC codes are 1 or 2 bytes’: 


_-— SNA codes are 1 byte 
— AMRU codes are 2 bytes—the first byte is X'FF'. 


e FMD codes are 3 or 4 bytes’: 
— SNA codes are 3 bytes 
— AMRU codes are 4 bytes—the third byte is X'FF'. 


You must fully specify all codes (the VIT analysis tool does not pad codes). 


7 Two hexadecimal digits represent one byte. For example, X'FF' is one byte. For RU counting, you must specify all hexadecimal 
digits and you must omit the X and quotes. For example, RU(NC(X'C')) is not valid; RU(NC(OC)) is valid. 
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RU(...) means process only the RUs with those codes. Each code is 1, 2, 3, or 4 
bytes. The VIT Analysis Tool counts these codes in any and all categories. For 
example, X'0D' is the NC code for NC-ACTVR and the SC code for ACTLU. If you 
specify RU(OD), the VIT analysis tool will count both of these RU codes. 


You can specify up to: 


32 codes for RU(NC(...)), 

32 codes for RU(SC(...)), 

32 codes for RU(DFC(...)), 

32 codes for RU(FMD(...)), 

32 codes for RU(AMRU(...)), and 
32 codes for RU(...). 


You can specify the RU codes individually or in lists. For example, 
RU(SC)31,32,FF31, FF32) ) 

is equivalent to 
RU(SC(31)) RU(SC(32)) RU(SC(FF31)) RU(SC(FF32)) 


RU(REQ) means process requests. RU(RESP) means process responses. By 
default (if you specify neither RU(REQ) nor RU(RESP)), the VIT analysis tool 
counts both requests and responses. 


RU(FROM(...)) means count RUs flowing from the specified network address to any 
network address. RU(TO(...)) means count RUs flowing to the specified network 
address from any network address. RU(FROMTO(...)) means count RUs flowing 
from the first network address to the second network address. You can specify up 
to: 


24 RU(FROM(...)) options, 
24 RU(TO(...)) options, and 
24 RU(FROMTO(...)) options. 


Each subarea field (subarea_numbepn is exactly 4 bytes 7. Each element field 
(element_number is exactly 2 bytes. The element fields are optional. For the 
RU(FROMTO(...)) option, if you omit the first element address, keep its comma as 
a place-holder. 


Note: You must specify the RU(FROM(...)), RU(TO(...)), and RU(FROMTO(...)) 
options individually. (You cannot combine them in lists like RU codes.) 


By default (if you specify neither RU(FROM(...)), RU(TO(...)), nor 
RU(FROMTO(...))), the VIT analysis tool ignores the origin and destination fields in 
the PlUs. 


RU(SORT(NAME)) means sort the request and response counts by RU name (the 


default). RU(SORT(FREQ)) means sort the counts by frequency (highest count 
first). 
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Combinations of RU options 

You can combine any or all of the RU options. When considering combinations of 
options, you might find it helpful to think of the RU options as two groups, as shown 
in Figure 60 and Figure 61. 


RU 
RU(NC(...)) 
RU(SC(...)) 
RU(DFC(...)) 
RU(FMD(...)) 
RU(AMRU(...)) 
RU(...) 


Figure 60. RU Code Options. These specify which RU codes to count. 


RU(REQ) 

RU(RESP) 

RU(FROM(...)) 

RU(TO(...)) 

RU(FROMTO(...)) 

RU(SORT(NAME)) 

RU(SORT(FREQ)) 
Figure 61. RU Modify Options. These options indicate whether to count request or 
response units, which origins and destinations to count, and the sort order for the count. 


The options in Figure 61 modify the options in Figure 60. For example, given the 
following combination of options, 


RU(REQ) RU 


the VIT analysis tool will count all requests for all RU codes. 


If you specify any modify option and no code option, the VIT analysis tool uses the 
default, which is the RU option. In other words, the VIT analysis tool counts all RU 
codes which match the modify options. The VIT Analysis Tool prints a message in 
the SUMMARY data set so you will know the RU option is in effect. 


The RU option (which counts all RUs) overrides the other code options (Figure 60). 
The VIT Analysis Tool prints a message in the SUMMARY data set so you will 
know the override is in effect. For example, given the following combination of 
options 


RU RU(NC(04)) 


the VIT analysis tool counts all RUs and does not check whether the specified RU, 
NC(04) in the example is found in the VIT. 


If any of the RU(FROM(...)), RU(TO(...)), or RU(FROMTO(...)) options match the 
origin or destination of an RU, the VIT analysis tool will count the RU. For 
example, you can ask for the counts of the following: 


e RUs from subarea X'00000012' 

e RUs to subarea X'00000012' 

e¢ RUs flowing between subarea X'0000004A' element X'000C' and subarea 
X'00000002'. 


by coding 


RU(FROM(00000012)) RU(T0(00000012) ) 
RU (FROMT0(0000004A, 000C, 00000002) ) RU(FROMT0(00000002, ,0000004A,000C) ) 
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If you list specific RUs (i.e., you specify any options in Figure 60 except RU), the 
VIT analysis tool does not count: 


e User RUs 
e FMH RUs 
e Unknown RuUs. 


(Although the VIT analysis tool reports the first occurrence of an unknown RU in 
the LOG data set.) 


Sample Output for RU Counting 


In this example, the following PARM file was submitted: 


Desc This example shows request/response unit counting 
Desc with a start time and a 30-second interval. 
RU STARTIME(02:04:30) interval (00:30) 


The resulting DETAILS, LOG, and SUMMARY datasets follow. 


Note: Ellipses indicate that part of the output has been omitted. The following is 
an example of a Summary report for RU counting, which is written to the data set 
name that you specify to receive the report. The DD name for the data set must be 
SUMMARY. 


This report is similar to the Summary report for storage analysis. See “Sample 
Output for Storage Analysis” on page 419 for details. 


VTAM V4 Trace Analysis Summary 92,.325 11/20 11:47:26 LOC 


This example shows request/response unit counting 
with a start time and a 30-second interval. 


Wrapped: No 

Formatting: Yes 

Interval: 00:30 

Start time: 91.199 07/18 02:04:30.000 LOC (A43572D6 64780000) 
Stop time: End of trace 


SMS: No 
RU: Yes 
Options: Requests Responses 
Sort: Name 
Codes: All 
From: All 
To: All 
From/To: All 
VITEXT: No 


KkkkkkkK KKK RK RR KKK RK KKK RRR RK KKK 
Observations 


There are 7 messages in the LOG file. 


Only 250 RUs were found in this trace. The findings should be verified on a 
larger trace. 


7 responses had sense data included. See the LOG data set. 


KEKKKEEKEEKKAKKERKEREREKKKEEKEK REE KKKRK KR ERRERERKEREKRRERKREKKERKKRIE 
Trace Statistics 


First GIF Timestamp: 91.199 07/18 02:03:13.266 LOC (A435728D 36BFAE01) 
First VIT Timestamp: 91.199 07/18 02:04:32.920 LOC (A43572D9 2D8DDE02) 


Last VIT Timestamp: 91.199 07/18 02:06:00.891 LOC (A435732D 12B57F02) 
Last GIF Timestamp: 91.199 07/18 02:06:00.891 LOC (A435732D 12B57F02) 
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Summary of GTF Record Types 


15 Timestamp control records 
6,930 VIT records 


6,945 Total GIF records 
Count of VIT Entry and Option Occurrences 


VIT Entry Occurrences 


1,390 FBLK 6 FBL2 

1,385 GBLK 6 GBL2 
104 MSG 104 MSGS 
217 MSG2 262 PIU 
746 PIU2 1,427 RELS 

1,414 REQS 6 REQ2 
415 VTAL 411 VTFR 

VIT Option Occurrences 

425 MSG 

1,008 PIU 

6,460 SMS 


7,893 Total 


The following is an example of a Detailed Report for RU counting, which is written 
to the data set name that you specify to receive the report. The DD name for the 

data set must be DETAILS. The RU counts for each interval are written following 

the title and description. The total count for all intervals is written at the end of the 
report. 


Under Requests, only the first GDS variable in each RU is counted. Under 
Responses, all RUs with sense data included are grouped together. Each RU with 
sense data included is printed in the LOG data set. For example, an UNBIND 

- response with sense data included is counted only as a response with sense data 
included, not as an UNBIND response. 


VTAM V4 Trace Analysis Detailed Report 92.194 07/12 18:51:46 LOC 


This example shows request/response unit counting 
with a start time and a 30-second interval. 


KEEKKKKKRKEKKKEKKKKEKEEKEKEKEKEEKEKEEKKEEEEKKEKKREEEEKKEKEEEREKRERAEAKEEKKKRERKKKKRKKKE 
Interval 1 


First VIT timestamp in this interval: 
91.199 07/18 02:04:32.920 LOC (A43572D9 2D8DDE02) (record 390) 


HEKEKKKEKEKEKEKKEKKKEEEEREKEKEKREEREREREEKREKREREKEEKEREKEREEKEREKEREEEREREERERKREKREEEKE 


RU Totals for Interval 1: 


Requests: 
1 RNAA 


Responses: 
1 FNA 1 RNAA 


2 Total responses 


KEKKKKEKKEKEKEKEKEKEEEKEEREEEEEEEEEEKREEERKEREREKREEEREREEREEKRERREREREEEKREEEEREKKRERE 


Last VIT timestamp in interval 1 
91.199 07/18 02:05:01.277 LOC (A43572F4 3877DE01) (record 429) 


KEKKKKEKEKEKEREKREKREEEKERKEKREEEEKREEEKREREKEREREEKEREEEEEKREKEERERRRERREREREEKEEREEE 
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Interval 2 
RU Totals: 
Requests: 
2 ACTLINK 7 BFCINIT 
4 BFCLEANUP 7 BFINIT 
2 BFSESSEND 5 BFSESSST 
5 BFTERM 18 BIND 
1 BINDF 4 CINIT 
5 CLEANUP 2 CONNOUT 
2 CONTACT 2 CONTACTED 
1 DACTLINK 1 DISCONTACT 
5 FMH-5 Attach-CP Capab 6 FMH-5 Attach-TDU 
9 FNA 4 GBIND BIND 
4 GDS CP Capabilities 7 GUNBIND 
3 INIT-OTHER 1 INOP 
1 NOTIFY (SSCP<-->LU) 3 RECMS 
2 REQCONT 11 RNAA 
5 SESSEND 5 SESSST 
23 UNBIND 
157 Total requests 
Responses: 
2 ACTLINK 7 BFCINIT 
1 BFCLEANUP 5 BIND 
4 CINIT 1 CLEANUP 
2 CONNOUT 2 CONTACT 
1 DACTLINK 1 DISCONTACT 
10 FNA 4 INIT-OTHER 
1 NOTIFY (SSCP<-->LU) 11 RNAA 
7 Sense Data Included 13 User 
21 UNBIND 


93 Total responses 
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The following is an example of an RU counting log, which is written to the data set 
name that you specify to receive the report. The DD name for the data set must be 
LOG. The Log contains important details found in the VIT during processing. For 
RU processing, the Log contains all RUs with included sense data. 

VTAM V4 Trace Analysis Log 92.194 07/12 18:51:46 LOC 


This example shows request/response unit counting 
with a start time and a 30-second interval. 


Sense data included at 02:05:56.653 LOC (record 1,990) 


Origin: 00000004 0073 
Destination: 00000001 0008 
Response Header: EF9000 Session Control 
Sense Data: 80050000 Path error 

No session 


Rejected RU code: 32 
Rejected Command: UNBIND 


Sense data included at 02:05:56.655 LOC (record 2,000) 


Origin: 00000004 0073 
Destination: 00000001 0008 
Response Header: EF90Q0 Session Control 
Sense Data: 80050000 Path error 

No session 


Rejected RU code: 32 
Rejected Command: UNBIND 


Sense data included at 02:06:00.372 LOC (record 6,706) 


Origin: 00000001 0008 

Destination: 00000001 0001 

Response Header: 8F9000 Function Management Data 
Sense Data: 08160000 Request reject 


Function already inactive 
Rejected RU code: 810629 
Rejected Command: CLEANUP 


Sense data included at 02:06:00.399 LOC (record 6,725) 


Origin: 00000004 0000 

Destination: 00000001 0001 

Response Header: 8F9000 Function Management Data 
Sense Data: 081E0001 Request reject 


Session reference error 
Rejected RU code: 812629 
Rejected Command: BFCLEANUP 


Sense data included at 02:06:00.456 LOC (record 6,774) 


Origin: 00000001 0008 

Destination: 00000001 0001 

Response Header: 8F9000 Function Management Data 
Sense Data: 08160000 Request reject 


Function already inactive 
Rejected RU code: 810629 
Rejected Command: CLEANUP 
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Extracting Information from the VIT 


Use VIT extraction to extract entries from a VIT. VIT entries extracted from a VIT 
can be formatted, displayed in hex with the eye-catcher, or copied in the same 
format as the input. 


Upon selecting VIT Extraction, the VIT Extraction Boolean Expression panel is dis- 


played as shown in Figure 62. 


ISTT0018 VIT Extraction Boolean Expression 


Type a Boolean expression or press F4 to use the template. 


Operands Description Operators 

CCcc or E'CCcc' Option or entry name () Delimiters 

A'XXXXXXxX' snn Address:offset — Not 

C'Ceccc...'snn Char String:offset - Through 
Hex String:offset & And 
Origin or Destination | Or 


Figure 62. VIT Extraction Boolean Expression panel 


The first time VIT extraction is invoked, the VIT extraction Boolean expression 
panel is blank. After the first time, the panel is displayed with the previously 
entered Boolean expression. 


You may specify the VIT entries you want extracted by entering a Boolean 
expression on this panel, or by filling in a template (one or more times). See 
“Using the Template” for information on how to use the template. Both methods 
result in a Boolean expression that specifies the criteria used to select VIT entries. 
VIT entries which contain the data specified by the Boolean expression are 
extracted. Extracted VIT entries may be formatted, displayed in hex with the eye- 
catcher or copied as is. See “Using the I/O Options” on page 445 for information 
on how to code these options. 


Using the Template 
To use the template, press F4. The VIT Extraction Template is displayed as shown 
in Figure 63 on page 435. 


All fields are optional. Any explicitly specified VIT entries, and VIT entries created 


by a specified option, are eligible for extraction if found in the trace. Only those 
eligible entries that meet all other specified selection criteria are extracted. 
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ISTTO014 VIT Extraction Template 


Type information in one or more fields, then press Enter. This information 
will be appended to the full expression. 


VIT options/entries 


Address (Hexadecimal ) 
Offset (Decimal or Hexadecimal) 


Character string 
Offset (Decimal or Hexadecimal ) 


Hexadecimal string 


Offset (Decimal or Hexadecimal) 


Command ===> 


Figure 63. VIT Extraction Template 


The fields on the template are described below. Fill in the template and press 
Enter. 


The template is checked for proper data type and length of data and saved. The 
resulting Boolean expression is then added to the VIT Extraction Boolean 
Expression panel. You can append multiple instances of the template, and a VIT 
entry that matches any of the templates will be extracted (when VIT extraction is 
invoked). The length of the resulting expression is limited to the input area on the 
VIT Extraction Boolean Expression panel. 


Press F3 to exit, and you are given the option to save the expression you have 
created. 


The fields on the extraction template are described as follows: 


VIT options/entries 
You may specify VIT options or entries to limit extraction to particular 
VIT entries. If you specify a VIT option, VIT entries created when the 
designated options are active are eligible for extraction if found in the 
trace. For example, the LOCK option generates the LKEX, LKSH, 
ULKA, and UNLK trace entries. If you specify LOCK and the LOCK 
option was used when the VIT was started, any LKEX, LKSH, ULKA, 
and UNLK entries found in the trace are eligible for extraction. 


Note: User-defined (SNAP) entries are allowed. See “SNAP Trace 
Record” on page 408. 


You may also specify particular VIT entries (for example, LKEX or 
LKSH), and an asterisk may be used in a VIT entry name to match any 
character (for example, LK* matches VIT entries LKEX and LKSH). If 
an entry with multiple parts is specified, all parts are extracted (for 
example, if Al2 is specified, Al1, Al2, and Al3 are extracted). 
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If no VIT options or entries are specified, all VIT entries are eligible for 
extraction. 


Entries with this address are eligible for extraction. Specify up to 8 hex 
characters for an address. If fewer than 8 digits are specified, the 
address is padded on the left with zeros. The low-order 31 bits of the 
address are then used to compare on all word boundaries if an offset is 
not specified. If an offset is specified, then only the offset is checked for 
a match. Address X'00000000' is allowed only when an offset for the 
address is also provided. 


Address offset 


The offset for an address is a word boundary offset into a trace record 
where a comparison should be made for the address. The offset must 
be one of the following: 


X'04', 4 

X'08', 8 

X'0C', 12 
X'10', 16 
X'14', 20 
X'18', 24 
X'1C', 28 


Character string 


Entries containing this character string are eligible for extraction. Enter 
a search string of 1-30 alphanumeric characters, which includes special 
characters (except a single quote). Data entered is not converted to 
uppercase. Data is case sensitive. By default, a comparison is made at 
all offsets. 


Character string offset 


You may include a byte offset into the VIT entries where comparisons 
should be made. The offset can be decimal or hex. The offset range is 
2-31 or X'02'—X'1F'. 


Note: The length of the character string determines the offset allowed. 
For example, if the character string entered consists of 8 characters, the 
valid offset range is 2-24. The string could not possibly start after byte 
24, since a VIT entry is 32 bytes long (byte 0 through byte 31) and 8 
bytes are needed to represent the string (bytes 24—31). 


Hexadecimal string 


Entries containing this hex string are eligible for extraction. Enter a 
search string of 2-60 hex characters representing 1-30 bytes of data. 
By default, a comparison is made at all offsets. 


If you code an odd number of hex digits, they are padded to the left with 


-a zero to make one byte. For example; X'D' is equivalent to X'OD'. 


Hexadecimal string offset 
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You may include an offset into the VIT entries where comparisons 
should be made. The offset can be decimal or hex. The offset range is 
2-31 or X'02'—-X'1F'. 


Note: The length of the hex string divided by 2 determines the offset 
allowed, since two hex digits represent one byte. For example, if the 
hex string entered consists of 8 hex digits, 4 bytes are needed to store 
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the string and the valid offset range is 2-28. The string could not pos- 
sibly start after byte 28, since a VIT entry is 32 bytes long (byte 0 
through byte 31) and 4 bytes are needed to represent the string (bytes 


28-31). 
Important Character and hex strings will not be found if they cross VIT 
Restriction entry boundaries. If a PIU is represented in the VIT as a 


PIU entry plus a series of PIU2 entries and a string is 
requested that spans the end of one PIU2 and the begin- 
ning of a second PIU2, it will not be found. 


Creating a Boolean Expression without the Template 
The template allows you to create many Boolean expressions, but there is no way 
to: 

e Negate an operand 

e Group operands 

e Specify AND or OR 

e Specify an operand multiple times on one template 

e Specify a range. 
To do any of this, you will need to enter an expression directly on the VIT 
Extraction Boolean Expression panel. Blanks are recommended between all oper- 
ands and operators. Again, the length of the expression is limited to the input area 
provided. No syntax error checking is performed. 


A sample free-form expression follows: 

Al» | (LOCK | E'PIU' & X'31':15 | 

GBL* & A'476C' - A'4800') 
This example selects each VIT entry that is either Ali, Al2, or AI3, or fulfills at least 
one of the following criteria: 

e LOCK option group (LKEX, LKSH, ULKA, UNLK) 

e PIU entry with value hex 31 at offset 15 

¢ GBLK or GBL2 entry with any address from X'0000476C' through 

X'00004800'. 

Operands: Following are the operands used in creating a Boolean expression. 
For further information on these operands, see “Using the Template” on page 434. 


VIT options or entries 
VIT entries with names identical to option names must be prefaced with 
an E and enclosed in single quotes (for example, E'MSG’'). This distin- 
guishes the name as an entry rather than an option. A VIT option or 
unique entry name requires no preface. 


Address Preface an address with an A and enclose it in single quotes (for 
example, A' xxxxxxxx', where xxxxxxxx is the hex address). 
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Address offset 


Specify the offset for an address after the address string, and separate 
the address string and the offset with a colon (for example, 

A' XXXxXxxxx':nn, where xxxxxxxx is the hex address and nn is the 
offset). 


Note: Only decimal offsets are allowed. 


Character string 


Preface a character string with a C and enclose it in single quotes (for 
example, C'ccccc...', where ccccc... represents the character string). 
Data is case sensitive. 


Character string offset 


Specify the offset for a character string after the character string, and 
separate the character string and the offset with a colon (for example, 
C'ccccc...':nn, where ccccc... is the character string and nn is the 
Offset). | 


Note: Only decimal offsets are allowed. 


Hexadecimal string 


Preface a hex string with an X and enclose it in single quotes (for 
example, X'xxxxx...', where xxxxx... represents the hex string). 


Hex string offset 


Origin 


Specify the offset for a hex string after the hex string, and separate the 
hex string and the offset with a colon (for example, X'Xxxxx...':nn, 
where xxxxx... is the hex string and nn is the offset). 


Note: Only decimal offsets are allowed. 


To extract PIU entries originating at a designated network address, enter 
1—12 hex characters (representing the 6-byte network address) in the 
form O'xx...'. - 


Note: The address is right aligned and padded with zeros on the left. 
For example, O'3001A' means subarea 3 element 1A. 


Destination 


All 


To extract PIU entries destined for a particular network address, enter 
1-12 hex characters (representing the 6-byte network address) in the 
form D'xx...'. 


Note: The address is right aligned and padded with zeros on the left. 
For example, D'4E' means subarea 0 element 4E. 


Specify ALL to extract all VIT entries. ALL is not valid with any other 
operand or operator. 


Note: You may also extract all VIT entries without entering the ALL 
operand. For example, 'gblk | - gblk' will extract all VIT 
entries. 


Operators: The operators used in creating a Boolean expression are shown in 
Figure 64 on page 439. 
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Operator Description 
() Parentheses 
- Not 
Through 
& And 
| Or 


Figure 64. Boolean Expression Operators in Order of Precedence 


Parentheses have the highest precedence and can be used to change the normal 
order of evaluation. The maximum nesting level is 15. The through operator (a 
hyphen) specifies a range and can be used for addresses or a hex string in the 
following combinations: 


e address-address 

e address:offset-address 

e hex string-hex string 

e hex string:offset-hex string 


If an offset is specified and you are using the through operator, the offset on the 
first operand is used for both operands. 


Parameter Syntax 

Use the following syntax only if you are using an editor to write your parameters as 
an alternative to the panel interface. 

p>>—VITEXT Boolean_express ion—————_"" 


Note: Up to 15 VITEXT parameters may be coded for longer Boolean 
expressions. 


VITEXT must be the first six characters and must be followed by a blank. 
The rest of the line is assumed to be the expression. 


Sample Output for VIT Extraction 
In this example, the following PARM file was submitted: 


desc This example shows VIT extraction. 

desc All PIU VIT entries to or from network address 000000040073 
desc and all MSGs with the string ACTIVE will be extracted. 
vitext 0'40073' | d'40073' | (MSG & c'ACTIVE') 

noformat 


The resulting VITEXT and SUMMARY datasets follow. 


Note: Ellipses indicate that part of the output has been omitted. The following is 
an example of a Summary report for VIT extraction, which is written to the data set 
name that you specify to receive the report. The DD name for the data set must be 
SUMMARY. 


This report is similar to the Summary report for storage analysis. See “Sample 
Output for Storage Analysis” on page 419 for details. 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Chapter 10. Using the VIT Analysis Tool (MVS, VM) 439 


Sample Output for VIT Extraction “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


VTAM V4 Trace Analysis Summary 92.325 11/20 11:47:45 LOC 


This example shows VIT extraction. 
All PIU VIT entries to or from network address 000000040073 
and all MSGs with the string ACTIVE will be extracted. 


Wrapped: No 
Formatting: No 
Interval: None 


Start time: Beginning of trace 
Stop time: End of trace 


SMS: No 
RU: No 
VITEXT: Yes 


0'40073' | d'40073' | (MSG & c'ACTIVE') 


KEKKKKKERERKKKEREEKEEKEREEEKEEKEKAAEKEREKEEEKEKEKRKKRKKK KKK KK RE 
Observations 


25 GTF VIT records were extracted and written to VITEXT. 


KKK KK EKA RRA KKK KK KARR KARR RRR 
Trace Statistics 


First GTF Timestamp: 91.199 07/18 02:03:13.266 LOC (A435728D 36BFAEQ1) 
First VIT Timestamp: 91.199 07/18 02:03:13.266 LOC (A435728D 36BFAE01) 


Last VIT Timestamp: 91.199 07/18 02:06:00.891 LOC (A435732D 12B57F02) 
Last GIF Timestamp: 91.199 07/18 02:06:00.891 LOC (A435732D 12B57F02) 


Summary of GTF Record Types 


16 Timestamp control records 
7,318 VIT records 


7,334 Total GIF records 
Count of VIT Entry and Option Occurrences 


VIT Entry Occurrences 


1,504 FBLK 6 FBL2 

1,498 GBLK 6 GBL2 
110 MSG 110 MSGS 
230 MSG2 279 PIU 
795 PIU2 1,464 RELS 

1,451 REQS 6 REQ2 
443 VTAL 439 VTFR 

VIT Option Occurrences 

450 MSG 

1,074 PIU 

6,817 SMS 


8,341 Total 
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The following is an example of a VIT Selections report, which is written to the data 
set name that you specify to receive the report. The DD name for the data set 
must be VITEXT. This report contains the VIT entries selected by the Boolean 
expression. 


The 'date' line containing the date, time, and record number for the first record 
extracted is written following the title and description. The title and description are 
not written if the TRACEFORMAT option is selected. The ‘date’ line is written at 
the beginning of the report and when the date changes. The time is written to the 
left of each record. | 


In this example, each VIT entry is written on one line and each line contains the 
time, the entry in hexadecimal, and the EBCDIC translation of the entry. 


VTAM V4 Trace Analysis VIT Selections 92.194 07/12 18:51:50 LOC 


This example shows VIT extraction. 
All PIU VIT entries to or from network address 00000004007 


and all MSGs 


with the string ACTIVE will be extracted. 


wee DATE *** 91,199 07/18 02:05:56.137 LOC (A4357328 8AQBB802) (record 881) 
02:05:56.137 D7C9E440 OC990000 06321010 40007870 20000037 00000001 G60OGG04 1D0Q0008 *PIU .1r..,... cece ee cc ceceenvonce * 
02:05:56.137 D7C9E4F2 66730018 00816B80 00310013 07B0B050 B33F8797 97870706 02000000 *PIU2..... Ay aseraees &. .GPPG...eee * 
02:05:56.137 D7C9E4F2 90000000 00230000 O4C1FOF2 D51FQ008 O2C3D7E2 E5C3D4C7 O90300E3 *PIUZ......... AQ2N....CPSVCMG...T* 
02:05:56.137 D7C9E4F2 FOS60FFA BBASOAOQ4 DS5C5E3C1 4BC1FOF2 D5@004C1 FOFIDSOE OAF3D5C5 *PIU29....v..NETA.AO2N. .AQIN. .3NE* 
02:05:56.137 D7C9E4F2 E3C14BC1 FOFZ2D50E OAF4D5C5 E3C14BC1 FOF2D52C OA010840 40404040 *PIUZTA.AQ2N. .4NETA.AO2N.... * 
02:05:56.137 D7C9E4F2 40404060 12E7E3F9 S6OFFABB A509D5C5 E3C14BC1 FOF2D500 00000000 *PIU2 -.XT9....v.NETA.AO2N..... * 
02:05:56.137 D7C9E440 0C990000 06321010 40007870 20000037 00000001 OBOGG0G4 1D0Q000S8 *PIU wri... .. Chee eee nee eee * 
02:05:56.137 D7C9E4F2 66730018 90816880 00310013 ©7BOB050 B33F8797 97870706 02000000 *PIU2..... ee &. .GPpg...... * 
02:05:56.137 D7C9E4F2 00000000 00230000 O4C1FOF2 D51FQ008 O2C3D7E2 ES5C3D4C7 090300E3 *PIUZ......... AO2N....CPSVCMG...T* 
02:05:56.137 D7C9E4F2 FO560FFA BBASOAQ4 D5C5E3C1 4BC1FOF2 D50004C1 FOFIDSOE OAF3D5C5 *PIUZ9....v..NETA.AO2ZN..AOQIN. .3NE* 
02:05:56.137 D7C9E4F2 E3C14BC1 F@F2D50E OAF4D5C5 E3C14BC1 FOF2D52C 0A010840 40404040 *PIUZTA.AOQ2N. .4NETA.AQ2N.... * 
02:05:56.137 D7C9E4F2 40404060 12E7E3F9 S60FFABB A509D5C5 E3C14BC1 FOF2D500 00000000 *PIU2 -.XT9....v.NETA.AO2N..... * 
02:05:56.712 D&E2C7E2 0C000000 00000000 OOQOFOF1 0039000 C9EZE3F1 FOF5C940 C1FOF4D7 *MSGS.......... 01..\.I1ST1051 A04P* 
02:05:56.712 D4E2C7F2 E4C3C1F3 40D5D6C4 C540D5D6 £640C9D5 C1C3E3C9 E5C56B40 D5D6C4C5 *MSG2UCA3 NODE NOW INACTIVE, NODE* 
02:05:56.722 D4E2C7E2 OCOCQO00 00000000 OOOOFOF1 O038E000 C9E2ZE3F1 FOF5C940 C1FQF4D3 *MSGS...... «.--01..\.I1ST1051 AQ4L* 
02:05:56.722 D4E2C7F2 D5C3C1F3 40D5D6C4 C540D5D6 £640C9D5 C1C3E3C9 E5C56B40 D5D6C4C5 *MSGZNCA3 NODE NOW INACTIVE, NODE* 
02:05:56.804 D4E2C7E2 0C000000 00000000 OOOOFOF1 OO2BE000 C9EZE3FO FOF3C940 CIFOF4E2 *MSGS.......... 01..\.1STO93I AO4S* 
@2:05:56.804 D4E2C7F2 F1F640C1 C3E3C9E5 C56B40D5 D6C4C540 E3E8D7C5 407E40D3 C9D5C508 *MSG216 ACTIVE, NODE TYPE = LINE.* 
02:05:56.883 D4E2C7E2 0C000000 GOC0000CR OOGOFOF1 OOZ2FEOOR CIEZE3FO FOF3C940 C1IFOF4D7 *MSGS.......... 01..\.1STO93I AO4P* 
02:05:56.883 D4E2C7F2 F1IF6F140 C1C3E3C9 E5C56B40 D5D6C4C5 4QE3E8D7 C5407E40 D7E46DE3 *MSG2161 ACTIVE, NODE TYPE = PU_T* 
02:05:57.239 D4E2C7E2 0C000000 00000000 OQOOFOF1 OO2DE00O C9EZE3FO FOF3C940 CIFOF4D3 *MSGS.......... 01..\.ISTO93I AO4L* 
02:05:57.239 D4E2C7F2 D5C3C1F3 40C1C3E3 C9ESC56B 40D5D6C4 C540E3E8 D7C5407E 40D3C9D5 *MSG2NCA3 ACTIVE, NODE TYPE = LIN« 
02:05:57.306 D4E2C7E2 OCO00000 00H00000 OQOOFOF1 OO30EOQO C9EZE3FO FOF3C940 C1IFOF4D7 *MSGS.......... 01..\.1STO93I AQ4P* 
:05:57.306 D4E2C7F2 E4C3C1F3 40C1C3E3 C9ESC56B 40D5D6C4 C540E3E8 D7C5407E 40D7E46D *MSG2UCA3 ACTIVE, NODE TYPE = PU_* 
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Using the Timing Options : | | 


After completing storage analysis, RU count, or VIT extraction, the timing options 
panel is automatically displayed. Use the timing options to report at certain inter- 
vals in the VIT or to process only the VIT records within a certain time range. By 
default, the entire VIT is processed. All time values, including time stamps, are 
local (LOC) time. The main panel for storage analysis is shown in Figure 65. 
Select an option and follow the prompts. 


ISTT0190 . Timing Options 
Select and type. Then press Enter. 
Start 1 . Beginning of trace 

2 


At timestamp (hex TOD clock) 
At date and time 


End of trace 
At timestamp (hex TOD clock) 
At date and time 


Report interval 


(MM:SS) (Storage Analysis and RU Counting only) 


Figure 65. VTAM Timing Options Panel 


Note: Report interval, start times, and stop times might not produce the expected 
output if the VIT was extracted from a dump using the VITAL option. VIT 
entries in a dump do not have individual time stamps. 


Start and Stop Time 

Start and stop times can be at a time stamp within the trace, at a date and time 
within the trace, or at the beginning of the trace for start and at the end for stop. If 
you do not specify a start or stop time, the entire VIT is processed. 


If you select 'At timestamp', another panel appears on which you may enter a 
System 370 time-of-day (TOD) time stamp. To ensure that the time stamp reflects 
your local time, you must add the time zone value to the high-order word. The time 
zone can be obtained from a dump, if the trace being used has been extracted 
from it, or by browsing the first time-stamp record from the trace in hexadecimal 
format. For example: 


A905470D237491E4 GMT TOD on a GTF trace record 
+ FFFFBCF1Q0000000 Time zone (padded with zeros) 


A90503FE237491E4 Local TOD 


You can enter either the high-order 4 bytes of the time stamp, such as X'A90503FE' 
or all 8 bytes, such as X'A90503FE237491E4'. 


Note: All hexadecimal time stamps reported by the VIT analysis tool are local time 
stamps. (The time zone has already been added.) 
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If you select 'At date and time', another panel appears on which you can enter 
both date and time selections. 
The time can be 
hh:mm:ss 
or 
hh:mmiss.ddd. 


The date can be 
Calendar format (mm/dd/yy) 
or 


Julian format (yy.ddqa). 


Report Interval 

If you select report interval, a report is written for each time interval determined 
from your selection. For example , if you have a storage analysis trace that was 
recorded for a 2 hour period and you specify an interval of 5 minutes, you get a 
report of the storage allocated and freed for every 5 minute period of the trace. A 
total for the whole 2 hours is printed regardless of the interval specified. 


Note: Interval is only valid for storage analysis and RU counting. 
Parameter Syntax 
Use the following syntax only if you are using an editor to write your parameters as 


an alternative to the panel interface. See “How to Read the Syntax Diagrams” on 
page 238. 
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p>— INTERVAL (mn: ss )'4+— 7 —— 7 
troce_record_start_date STARTIME (60:00:00.000) 


STARTCAL (mm/dd/y3 _-STARTIME (hh:mm:ss) 


STARTJUL (yy .ddd) 44) -STARTIME (hh:mm:ss .ddd) 
STARTHEX (xxxxxxxx) nee 


STARTHEX (XXXXXXXX XXXXXXXX) 


trace_record_stop_date STOPTIME (23:59:59.999)— 


STOPCAL (mn/dd/y STOPTIME (hh:mm:ss) 
STOPJUL (yy.ddd)* STOPTIME (hh:am:ss .ddd) 
STOPHEX (xxxxxxxx) 
STOPHEX (XXxxXXXXX XXXXXXXX) 
Notes: 
1 


INTERVAL cannot be used with VIT extraction. INTERVAL can be used with any 
start or stop time specification. Intervals (mm:ss) are interpreted as 00 through 
99 for minutes, and 00 through 59 for seconds. 
2 If you do not code a start date, the VIT analysis tool uses the date on the first 
trace record. 
The calendar date ( mm/dd/yy) is 01 through 12 for month, 01 through 31 for 
day, and 00 through 99 for year. For dates, yy values 43-99 are interpreted as 
1943-1999, and yy values 00-42 are interpreted as 2000-2042. 
The Julian date ( yy.ddd) is 00 through 99 for year and 001 through 366 for day. 
For dates, yy values 43—99 are interpreted as 1943-1999, and yy values 00-42 
are interpreted as 2000-2042. 
Calendar time (hh:mm:ss.dda) is 00 through 23 for hour, 00 through 59 for 
minutes, 00 through 59 for seconds, and 000 through 999 for milliseconds. 
6 If you do not code a stop date, the VIT analysis tool uses the date on the first 
trace record. 


[*) 


oN 


on 
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Using the I/O Options 


The I/O Options panel is displayed automatically after the Timing Options panel. 


Us 


e the I/O options to designate a wrapped trace, whether or not you want for- 


matted output, or to specify a title or description for the first page of a report. The 
main panel for the 1/O options is shown in Figure 66. Select an option and follow 
the prompts. 


ISTT9022 Input/Output Options 
Type, then press Enter. 


Trace wrapped? 2 1. Trace wrapped 
2. Trace did not wrap 


Format output? 1 1. Format the VIT entries 
2. Do not format 
3. Create trace data set 


Trace Analysis 


Description 


Command ===> 


Figure 66. VTAM I/O Options Panel 


Trace Wrapped 

Select Trace wrapped if the trace wrapped when it was recorded. Wrapped means 
that the trace ran out of space on the specified device and began to write over 
previously recorded data. A trace recorded on a DASD device is usually large 
enough to wrap. A trace recorded on a tape will not wrap. 


Format Output 
VIT entries can be written formatted, unformatted or as a hexadecimal string. Here 
is a GBLK entry in each format: 


¢ Do not format (parameter syntax: NOFORMAT). Shows the 32 byte VIT entry 
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as 8 words in hexadecimal format, followed by the same 32 bytes as the 
EBCDIC eye-catcher. For example, 


C7€20302 9C090900 96638480 96357218 82306340 90000098 S64EBCF8 00000098 *GBLK...... er De. os qf+.8.. 


Format the VIT entries (parameter syntax FORMAT). Shows the 32 byte VIT 

entry with labels for each field. For example, 

GBLK ASID OC RC 90 ID 00 VTA 900 AREA 06638480 ANCH 06357218 
ISSR 82306340 LEN 09000098 INIT S64EBCF8 RLEN 60000098 

Create trace data set (parameter syntax TRACEFORMAT). The 24-byte GTF 

header followed by the 32-byte entry in hexadecimal format. This output is not 

suitable for printing, but is usable as input to the VIT analysis tool or other 

tools. For example, 


..U.,e5et....7..VIAMIST GBLK......d..... D.. ...qft.8...g 


qr 


//O Options 


- “Restricted Materials of IBM” 
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Parameter Syntax 
Use the following syntax only if you are using an editor to write your parecer as 
an alternative to the panel interface. 


NOWRAP FORMAT, 
3 7 : eat LTITLe ee Lpesc ccC.. a 
TRACEFORMAT 


Operands 
Notes: 


Is 
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lf FORMAT is specified and the VTAM format module is not found or is 
unusable, a message is issued and the job is stopped. To recover, do either of 
the following and rerun the job. 


e Find the current version of AMDUSRFD and add a STEPLIB DD statement 
to your application 

¢ Specify NOFORMAT to print the VIT entries in hexadecimal with an eye- 
catcher. 


. The TRACEFORMAT option is valid only for VIT extraction, and results in 


output in the same format as that of the TRACE input dataset. 


. If you specify the TRACEFORMAT option, the output from the VIT analysis may 


be processed by: 


e The VIT analysis tool 

e ACF/TAP 

e IPCS GTFTRACE, unless the VIT was recorded internally and was 
extracted from a dump by the VTAMMAP VITAL function. 


. The 20 characters following the word TITLE are used as the title. The rest of 


the input line is ignored. 


. DESC may contain up to 75 additional characters, and you can code up to 4 


DESC parameters. DESC must be the only option on the line and must be the 
first 4 characters on the line followed by at least one blank. 
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Creating Your Own Parameter Dataset 
The PARM dataset must have fixed records (can be blocked) with: 


e LRECL=80 
e RECFM=FB 


The parameters can be coded in any order, and in lowercase, uppercase, or mixed 
case. Code only one function parameter (SMS, RU, or VITEXT) per job or exe- 
cution. See the parameter syntax for each trace function for a list of the possible 
parameters that may be coded. 


Restriction The parameters shown in Figure 67 can be coded in parts 
to avoid exceeding the maximum line length of 80 charac- 
ters, but a single parameter cannot be continued on the 
next line. 


SMS(GBLK(0,1,...255)) 
SMS(VTAL(0,1,...255)) 
SMS(REQS(bufname....)) 
DESC ccc... 
RU(NC(xx,xx,...xx)) 
RU(SC(xx,Xxx,...XxX)) 
RU(DFC(xx,xx,...xx)) 
RU(FMD(xxxxxx,XXXXXX, ...XXXXXX)) 
RU(AMRU (20cxx, ...XxXxXxXXX)) 
RU(xx, ...XxXXXXXX)) 

VITEXT Boolean expression 


Figure 67. Parameters Coded on Multiple Lines 


For example, SMS(GBLK(0,1,2,3)) can be split onto multiple lines as follows: 


SMS (GBLK (0) ) 
SMS (GBLK(1) ) 
SMS (GBLK (2) ) 
SMS (GBLK (3) ) 


Notes: 


1. If you use an editor, you may include comments in your parameter data set. 
An asterisk in column one identifies a line as a comment line. If you use the 
panel interface, you cannot enter comment lines. 


2. You may use the DEBUG option to gather information to solve problems with 
the tool itself. To use it, enter DEBUG with one of the VIT analysis options. 


3. Lines can not be continued. Each parameter must be fully specified on one 
line. 


Sample Parameter Data Set 
Following is a sample parameter data set. 


SMS(VTAL) sms(match) SMS(Lengths) 

INTERVAL(00:15) STARTIME(12:42:14) STOPTIME(14:00:00) 

DESC This is an analysis of the VTAL and VTFR VIT entries. 

DESC This will tell the high-water mark (the most storage used) 

DESC from the start time to the stop time. 

DESC This job will also report the storage used in 15-second intervals. 
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See “Analyzing Storage” on page 417, “Counting Request/Response Units (RUs)” 
on page 426, or “Extracting Information from the VIT” on page 434 for additional 
explanation of the parameters. 


Also see “Using the Timing Options” on page 442 and “Using the I/O Options” on 
page 445. 
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Chapter 11. Using VSCS Service Aids (VM) 


The following tools can help you diagnose VSCS problems: 


e Messages, see “Message and Module Conventions” 

e Operator console listing, see “Operator Console Listing” on page 450 

e Operator commands: BFRFIFO, CHANGE, QUERY, DISPLAY, FORCE, and 
STORAGE, see “Operator Commands” on page 450 

e VSCS dump, see “VSCS Dump” on page 453 

e VSCS trace facility, see “VSCS Trace Facility” on page 458. 


These service aids, along with service aids for VTAM, can help you isolate prob- 
lems to a single component and identify problems within VSCS. 


Message and Module Conventions 


For most messages, the module name appears as the first word in the message 
text. For example, in the following message DTICO1I, DTICINIT is the module 
name. 


DTICO1I DTICINIT VSCS IUCV INITIALIZATION IS IN PROGRESS 


All VSCS message and module identifiers begin with DTI. Module names are in 
the form DTlcaaaa, where aaaa is the unique module identifier and c represents 
the issuing subcomponent, as follows: 


C Communication services for inter-user communication vehicle (IUCV) 
| Initialization and termination services 
P Presentation services 
In this subcomponent (DTIPaaaa), the fifth letter is one of the following: 
D Device manager 
F Force processing 
| Input manager 
O Output manager 
R Request services 
S State manager 
S System services 
V VTAM services 
In this subcomponent, a module with the last character of X (DTIVaaax) indi- 
cates a VTAM exit routine. 
X System services (messages only) 


Message identifiers are in the form DTlcnni, where c indicates the issuing compo- 
nent (as above), nn is the two-digit serial number, and /is the action indicator: 


A Action 
E Eventual action 
| Information 


For internal VSCS errors, DTIMSGE macro requests issue the following message, 
where modname indicates the name of the module that issued the message, and n 
identifies the nth occurrence of the DTIMSGE macroinstruction within the module: 


DTIS99I INTERNAL VSCS ERROR modname n [netid. luname] 
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The number n can be used to identify the reason the message was issued. See 
“Message Problems: Message DTIS99I Indicates a VSCS Internal Error’ on 
page 176 and VTAM Messages and Codes for more information. 


Operator Console Listing 


The operator console listing is a printout of the messages that appear at the VSCS 
operator console. The listing contains everything that appears on the operator's 
console during the entire session. It can help you find out the sequence of events 
when a problem occurs. If VSCS is running in the same virtual machine as VTAM, 
the console listing includes VTAM messages as well as VSCS messages. 


_ To obtain a console listing, issue the CP command SPOOL CONSOLE START. If 
you are using a hard-copy terminal, such as a 3767, this is not necessary because 
all input and output already comes out on paper. 


Note: If the operator console is in CONMODE 3270, the CP SPOOL CONSOLE | 
command produces no output. 


To determine what book describes CP operator commands for your operating 
system, see Table 80 on page 1165. 


Operator Commands 


The following commands are described in more detail in Chapter 4, “VSCS Oper- 
ator Commands (VM)” in VTAM Operation. For a description of the messages in 
the output examples, see VTAM Messages and Codes. 


BFRFIFO Command 

BFRFIFO affects the dequeueing and dispatching structure for storage. Generally, 
storage is used from the top in a last-in-first-out fashion (BFRLIFO). This is the 
default. For diagnostic purposes, however, you can turn on BFRFIFO. This first-in- 
first-out method of storage preserves the storage element queue long enough for 
you to take a dump and see the storage elements that have just been processed. 


Note: The VSCS STORAGE command will show the current queuing method in 
use. 


To start BFRFIFO, use the VSCS BFRFIFO command or the DTIGEN macroin- 
struction. For more information on the DTIGEN macroinstruction see Chapter 5, 
“VM/SNA Console Support (VSCS)” in the VTAM Resource Definition Reference. 


Note: Using BFRFIFO can seriously degrade system performance, especially in a 
large network, and prevents the storage manager check and release functions from 
executing or functioning. 


CHANGE Command 

The CHANGE command enables you to modify various DTIGEN start options 
without having to halt and restart VSCS. When you use the CHANGE command to 
change DTIGEN start options, the changes are in effect only while VSCS is active. 
With the CHANGE command, you can affect VSCS' use of: 


e Storage when sending or receiving data for a logical unit 
e System dump facilities during repetitive dump situations 
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e User exit control. 


For more information on the CHANGE command, see “VSCS CHANGE Command” 
in VTAM Operation. For information on the DTIGEN start options, see “VSCS Start 
Options” in the VTAM Network Implementation Guide. 


DISPLAY Command 
e The VSCS command DISPLAY |ID=netid./uname shows the status of a single 
logical unit. 


e The VSCS command DISPLAY ID=/uname shows the status of all the logical 
units with /uname, regardless of their network IDs. 


Figure 68 shows example output from the VSCS DISPLAY command with netid 
specified. 

vscs d id=aQla721 

Ready; 

DTIS60I DISPLAY COMMAND ACCEPTED 

DTIS611 LU NAME = NETA.AQJA721 DEVICE TYPE = 3278 MODEL = 3 

DTIS62I LU TYPE = © DEVICE FEATURES = EDS APL( NEW ) COLOR 

DTIS63I SCREEN SIZE = 24 BY 80 ALTERNATE SIZE = 32 BY 80 PACE = 32 

DTIS65I IUCV PATHIDS = 2 5 CURRENT RPL COMMAND = SEND RPL IS FREE 

DTIS661 CURRENT STATES: PS = NMH VS = NORM DR 

DTIS671 LOGON TIME = 15 : 25: 16 

DTIS681 SEND COUNT = 00000005 RECEIVE COUNT = 00000001 

DTIS741 TRACE TABLE STARTS AT 002C8010 END OO2C8FEF , CURRENT 002C8010 , SIZE 126 
DTIS771I VSCS COMMAND PROCESSING COMPLETE 


Figure 68. Example of the VSCS DISPLAY Command Output 


DUMPLU Command 

The VSCS DUMPLU command enables the operator to obtain documentation for 
one or more VSCS logical units without having to dump the entire VSCS virtual 
machine. A partial dump is taken of the VSCS control blocks and work elements 
associated with each logical unit specified. If netid is not specified on the 
command, then all logical units with the specified name will be dumped. See 
“VSCS DUMPLU Command’ in VTAM Operation for information on DUMPLU. 


FORCE Command 

The VSCS command FORCE |ID=/netid.]iuname terminates the CP session and 
VTAM session for a logical unit. If netid is not specified on the command, it will 
default to the host network ID. This command may be used when the CP FORCE 
and VTAM VARY INACT commands do not terminate a logical unit. 


QUERY Command 
The VSCS QUERY command displays the following information: 


e The location of the VSCS trace table (if it has been allocated) 
e The status of VSCS traces 

e The status of a VSCS dump 

e The status of buffer queues. 


Figure 69 on page 452 shows an example of the messages issued in response to 
the VSCS QUERY command. 
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vscs query 
Ready; 

DTIS74I TRACE TABLE STARTS AT 00299020 END Q02A0D5F , CURRENT 00299880 , SIZE 2000 
DTIS82I NON-SELECTIVE CCS, VTAM TRACE ACTIVE 

DTIS97I INDIVIDUAL LU TRACE TABLES ENABLED, SIZE = 120 

DTIS93I VSCS EXTERNAL TRACE IS DISABLED 

DTIS78I BUFFER DEQUEUE IS IN NORMAL MODE(BFRLIFO) 

-DTIS771 VSCS COMMAND PROCESSING COMPLETE 


Figure 69. Example of the VSCS QUERY Command Output 


STORAGE Command | 

The VSCS STORAGE command shows the status of VSCS dynamic storage and 
static storage and some DTIGEN options that are involved with VSCS dynamic 
storage and static storage usage. Figure 70 shows an example of the output that 
results from the VSCS STORAGE command when both STCHKTM and STRELTM 
dre zero. For more information on the DTIGEN macroinstruction, see Chapter 5, 
“VM/SNA Console Support (VSCS)” in the VTAM Resource Definition Reference. 


vscs storage 


Ready; 

DTIS15I DYNAMIC STORAGE UTILIZATION — 

DTIS16I RCVBFRL - 284 DPXMTL - 1268 KPXMTL - 284 
DTIS17I RPLNUM - 255 VSAMLM - 10 VEIBS’ - 15 
DTIS18I BLKMULT - 1 STCHKTM - Q@ STRELTM - 0 
DTIS19I GETMAIN - 43 FREEMAIN - 1 SWAP - 0 
DTIS20I VTAMSES - 1 CPCONNS - 1 CPMAX - 1 
DTIS11I SPECIAL - 0 SPGET - 0 SPFREE - 0 
DTIS12I BADSIZE - © BADCOUNT - 0 

DTIS5OI STATIC STORAGE UTILIZATION 

DTIS23I PATHTAB - 1608 LOGO - 2520 VTAMWA - 29040 
DTIS24I PRINTER - 0 K TRACE - 2000 K 


DTIS77I VSCS COMMAND PROCESSING COMPLETE 
Figure 70. Example of the VSCS STORAGE Command, STCHKTM=0 and STRELTM=0 


Figure 71 shows an example of the VSCS STORAGE command when either 
STCHKTM or STRELTM is greater than zero. 


vscs storage 


Ready; 

DTIS15I DYNAMIC STORAGE UTILIZATION 

DTIS16I RCVBFRL - 284 DPXMTL - 1268 KPXMTL - 284 
DTIS17I RPLNUM - 255 VSAMLM - 10 VEIBS’ - 15 
DTIS18I BLKMULT - 1 STCHKTM - 1 STRELTM - 10 
DTIS19I GETMAIN - 43 FREEMAIN - 1 SWAP - 0 
DTIS20I VTAMSES - 1 CPCONNS - 1 CPMAX - 1 
DTIS11I SPECIAL - © SPGET - © SPFREE - 0 
DTIS12I BADSIZE - @ BADCOUNT - ) 


DTIS14I DYNAMIC STORAGE IN USE 
DTIS21I POOL HIGHWATER/VTAMSES CURRENT AVAILABLE LIFO 


DTIS22I PS 10 / ] 10 8 TOTAL= 56 K 
DTIS22I VS 26 / ] 26 1 TOTAL= 104 K 
DTIS22I_ VX 5 / 1 5 3 TOTAL= 20 K 


DTIS14I DYNAMIC STORAGE NOT IN USE 
DTIS211 POOL HIGHWATER/VTAMSES CURRENT AVAILABLE LIFO 


DTIS22I $1 0 / 0 ) Q TOTAL= 0 K 
DTIS221 82 0 / 0 0 @ TOTAL= 0 K 
DTIS221 $3 0 / ) 0 @ TOTAL= 0K 
DTISSOI STATIC STORAGE UTILIZATION 

DTIS23I PATHTAB - 1608 LOGO - 2520 VTAMWA - 29040 

DTIS24I PRINTER - 0 K TRACE - 2000 K 


DTIS771 VSCS COMMAND PROCESSING COMPLETE 
Figure 71. Example of the VSCS STORAGE Command, STCHKTM>0 or STRELTM>0 
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VSCS Dump 


The VSCS dump contains all of the storage for VSCS. It also contains common, 
group control system (GCS), and VTAM storage if they are in the same virtual 
~machine as VSCS. 


While the dump is being taken, all network activity temporarily stops in order to 
keep the contents of the dump intact. When the dump is requested, VSCS issues 
a message containing the name of the module requesting the dump and a dump 
identifier number. VSCS dumps are numbered to correlate to the console mes- 
sages. 


Note: If you get a VSCS dump using the DUMPLU command, only LU data is 
complete. The dump is not numbered. 


Use the link-edit listing to locate key modules or work areas in the dump. The 
addresses of CSECTs DTIISDA1 and DTIISDA2 also appear in the trace table 
header record, as shown in Figure 74 on page 461. DTIISDA1 and DTIISDA2 
contain the global control blocks, which can be identified in the dump by their 
unique identifiers. For more information on control block identifiers, see “VSCS 
Storage and Control Block ID Codes (VM)” on page 1139. 


For more information on controlling dumps, see “Controlling VSCS Dump Points” in 
VTAM Customization. 


Dump Formatting Routine 


VSCS provides a dump formatter to format VSCS control blocks and the VSCS 
internal trace table in a dump. The routine runs as part of PRTDUMP. To produce 
formatted dump output, do the following: 


1. Use the GCS GDUMP or CP VMDUMP command to dump VSCS storage. 

2. Use DUMPLOAD to process the reader file produced by the dump. 

3. Use PRTDUMP to format the VSCS control blocks and internal trace table. 
Note: You cannot print an entire dump using PRTDUMP. Use DUMPLOAD to 
print the entire dump. 


See Table 80 on page 1165 to determine what book contains more information on 
dump collecting and dump formatting for your operating system. 


Use the VSCS QUERY command to find the location of the VSCS internal trace 
table. Record the address. If you cannot find the proper control blocks, you can 
still use the table's address to find them using the dump formatter. 


The general format of contro! blocks in a formatted dump is: 
Control block name and address 
Control block information | 
OGfSCL., oieeieee. data in dump format......... *,.printable..* 


The five options shown in Table 32 on page 454 allow you to choose what portion 
of the dump you want to format. 
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Table 32. Dump Formatting Options for VSCS 


1 


DTICGB 

DTICIA 
DTICLBs 
DTICMDs 
DTIDCES 
DTIDMP 
DTIDSBs 
DTIGTD 
DTIPACT 
DTIPGB 
DTIPIBs 
DTIPLBs 
DTIPRM 
DTISAB 

DTISCB 
DTISWBs 
DTITABs 
DTIUGB 
DTIVGB 
DTIVLBs 

Path table 
IFGACB 

Receive RPLs 
DTISCB summary 
Send RPL 
Global trace table 
VTAM work area 
IHASDWA 
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Note: For partial dumps created by DUMPLU, or requested for LU-related internal 
errors, the VSCS formatter does not allow you to specify any options. The title of | 


_ the dump is displayed and the dump is processed without prompting the user. The 


output is similar to the output produced by the “Specific LU control blocks” option. 


2 


DTIPDBs 
DTISDBs 
DTISCB summary 


3 4 5 


DTICLB Module list 
DTICMT 
DTIPIBs 
DTIPLB 
DTITAB 
DTIVEIB 
DTIVLB 
DTIWEB 
DTIXMT 
Logical unit 
trace entries 
ISTNIB 
Receive RPL 
Send RPL 

ILU trace table 


Global trace table 


Formatting may terminate if any of the following conditions occur: 


e You are trying to process a back-level dump for either VTAM or VSCS. 


e VSCS cannot find the control blocks in the dump. Early in initialization and late 
in termination, the appropriate pointers and exits may not exist. If VSCS 
cannot find the control blocks, it issues a message asking you for the VSCS 
trace table address. From this, it can locate the control blocks. 


e Validity checking shows that a control block has been overlaid with data. 


e A page of storage that VSCS needs is unavailable. 


Figure 72 on page 455 shows how to use the dump formatting routine. This 
example is taken from an operator console listing. 
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prtdump prb00001 
PROCESSING FILE 'PRBOQOO1 DUMP' 


VSCS Dump Formatting Routine 


CSIIPR550R DO YOU WISH TO FORMAT VTAM CONTROL BLOCKS? REPLY YES OR NO 


y 


FORMAT VSCS CONTROL BLOCKS? (YES OR NO) 


y 


DTIFTO4 - VSCS V4R2 DUMP FORMATTER 
DTIFT@5 - VSCS CONTROL BLOCKS LOCATED 
DTIFTO1 - VSCS DUMP FORMATTING OPTIONS 


STORAGE CONTROL BLOCKS 

SPECIFIC LU CONTROL BLOCKS 

VSCS TRACE TABLE ONLY 

VSCS MODULE CROSS REFERENCE LISTING 
USER PROVIDED TITLE 

EXIT 


HOA PWD = 


ENTER OPTION(1-5), T-TITLE OR Q-EXIT: 


t 


TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 


DTIFT11 - ENTER DESIRED TITLE(UP TO 120 CHARACTERS) 


Prb8997a - Printer hang situation 
DTIFTO1 - VSCS DUMP FORMATTING OPTIONS 


1. TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 


STORAGE CONTROL BLOCKS 
SPECIFIC LU CONTROL BLOCKS 
VSCS TRACE TABLE ONLY 


USER PROVIDED TITLE 
EXIT 


oOooA OP Ww Pp 


ENTER OPTION(1-5), T-TITLE OR Q-EXIT: 


1 


VSCS MODULE CROSS REFERENCE LISTING 


DTIF101 - SHOULD THE VSCS INTERNAL TRACE TABLE BE PROCESSED? Y|N 


y 


DTIF102 - ENTER TRACE OPTION: 
F. FORMATTED 

U. UNFORMATTED 

ENTER OPTION(F OR U): 


f 
DTIF203 - SORTING 04 LU'S BY NAME 


DTIF203 - SORTING 04 LU'S BY ADDRESS 


DTIFTO1 - VSCS DUMP FORMATTING OPTIONS 


STORAGE CONTROL BLOCKS 

SPECIFIC LU CONTROL BLOCKS 

VSCS TRACE TABLE ONLY 

VSCS MODULE CROSS REFERENCE LISTING 
USER PROVIDED TITLE 

EXIT 


oo np wPDd ee 


ENTER OPTION(1-5), T-TITLE OR Q-EXIT: 


TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 


Figure 72 (Part 1 of 3). Using the VSCS Dump Formatting Routine 
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VSCS Dump Formatting Routine 
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DTIFTQ1 - VSCS DUMP FORMATTING OPTIONS 


HouANPWDY 


EXIT 


TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 
STORAGE CONTROL BLOCKS 

SPECIFIC LU CONTROL BLOCKS 

VSCS TRACE TABLE ONLY 

VSCS MODULE CROSS REFERENCE LISTING 

USER PROVIDED TITLE 


ENTER OPTION(1-5), T-TITLE OR Q-EXIT: 


3 


ENTER LUNAME(1-8 CHARACTERS) : 


viam 


DTIFTO3 - FORMATTING VTAM 
DTIF204 - SEARCHING FOR LU.... 


LU CONTROL BLOCKS 


DTIF205 - EXTRACTING LU TRACE ENTRIES... 


DTIF201 - LU NAME NETA.VTAM 


PROCESSED 


DTIFTO1 - VSCS DUMP FORMATTING OPTIONS 


Aa AO RP WY 


EXIT 


TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 
STORAGE CONTROL BLOCKS 

SPECIFIC LU CONTROL BLOCKS 

VSCS TRACE TABLE ONLY 

VSCS MODULE CROSS REFERENCE LISTING 

USER PROVIDED TITLE 


ENTER OPTION(1-5), T-TITLE OR Q-EXIT: 


Figure 72 (Part 2 of 3). Using the VSCS Dump Formatting Routine 
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4 


DTIFTO2 - ENTER TRACE OPTION: 


F. FORMATTED 
U. UNFORMATTED 


ENTER OPTION(F OR U): 


U 


DTIFTO1 - VSCS DUMP FORMATTING OPTIONS 

TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 
STORAGE CONTROL BLOCKS 

SPECIFIC LU CONTROL BLOCKS 

VSCS TRACE TABLE ONLY 

VSCS MODULE CROSS REFERENCE LISTING 

USER PROVIDED TITLE 


HAO PWD 


EXIT 


ENTER OPTION(1-5), T-TITLE OR Q-EXIT: 


5 


DTIFT69 - SEARCHING FOR MODULE NAMES 

DTIFT1@ - SORTING MODULE NAMES BY NAME 
DTEFT16 - SORTING MODULE NAMES BY ADDRESS 
DTIFTO1 - VSCS DUMP FORMATTING OPTIONS 

TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 
STORAGE CONTROL BLOCKS 

SPECIFIC LU CONTROL BLOCKS 

. VSCS TRACE TABLE ONLY 

. VSCS MODULE CROSS REFERENCE LISTING 

USER PROVIDED TITLE 


EXIT 


DOAN Ww DN ee 


ENTER OPTION(1-5), T-TITLE OR Q-EXIT: 


q 


FORMAT VTAM CONTROL BLOCKS? (YES OR NO) 


n 


VSCS Dump Formatting Routine 


Figure 72 (Part 3 of 3). Using the VSCS Dump Formatting Routine 
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The VSCS trace facility offers the following trace options: 


Console communication services (CCS) trace 


Cleanup trace 


Data trace (DAT) 


Creates one entry for each IUCV request or response sent or 
received by VSCS. 


Creates entries for LU cleanup and global error situations that 
can occur, like abends, internal errors, or requests from CP that 
are not valid. This trace is activated automatically when one or 
more of the VSCS trace options are activated. It cannot run by 
itself. 


Creates one entry for logical unit-bound data (output), and one 
entry for CCS-bound logical unit data (input). 


Dispatcher trace (DISP) 


FRE trace 
GET trace 


Creates one entry each time DTIPSTAM or DTIVSTAM gives 
contro! to another module to process a work element block. 
This can occur more than once for a single work element block. 


Creates one entry for each request to free a block of storage. 


Creates one entry for each request for a block of storage. 


Operator trace (OPER) 


Creates one entry for each command processed and message 
issued by VSCS. 


Storage statistics trace (STAT) 


Creates one entry, which is recorded externally, each time ih 
STCHKTM time interval expires. 


VTAM exit trace (VTAM) 


Creates one entry each time VTAM gives control to a VSCS 
VTAM exit. 


Note: Each trace option causes some system degradation, but it can be controlled 
to some extent. The cleanup, CCS, operator, and storage statistics traces cause 
the least system degradation. The VTAM exit trace causes a little more degrada- 
tion, and the data, dispatcher, FRE, and GET traces cause the most degradation. 
Consequently, the CCS and VTAM exit traces are the defaults. 


Figure 73 on page 459 shows where each trace occurs. 
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Presentation 
Services 


Communi cation 
Services 


Services 
Exits 


Services 
VTAM 
API 


CP 


Data 
Dispatcher 


CCS STAT VTAM Exit. 


Cleanup 


Figure 73. Where VSCS Traces Gather Data 


Activating VSCS Traces 


All of the traces except cleanup are started with operator commands. (For the CCS 
and VTAM exit trace options, the default is active.) The cleanup trace starts auto- 
matically with any of the other traces. See “VSCS Tracing Commands” in VTAM 
Operation for more information on starting the VSCS traces. 


A trace can be started for one logical unit, up to 64 specific logical units, or all 
logical units at any time. If a trace is running for all logical units and the TRACEON 
command is specified for a single logical unit, the trace only records data for the 
logical unit specified. In the same manner, if you are tracing a specific logical unit 
and issue VSCS TRACEON (ALL, the trace then records data for all logical units. 


If one or very few logical units are experiencing a problem, and you are re-creating 
the problem to get documentation, only run the traces on the logical units causing 
problems, and specify the ILU and SIZE options. By focusing on individual logical 
units, you can reduce extraneous trace data, trace table wrapping, and negative 
impacts on system performance. 


When you specify the ILU option, VSCS allocates an individual trace table for each 
LU that is traced. Use the SIZE option with the ILU option to set the size of each 
LU table. VSCS still records trace entries to the global VSCS trace table when the 
ILU option is active. See “VSCS Tracing Commands’ in VTAM Operation for 
instructions on using the ILU and SIZE operands. 


The external trace option prevents trace information from being overlaid when the 
internal table wraps. If MODE=EXT, VSCS maintains both the internal trace table 
and the external trace table. This ensures that a dump taken for an unrecoverable 
error will contain the relevant data from the internal trace table. The external VSCS 
trace entries are sent to the external recording facilities of CP. See “Using the 
External VSCS Traces” on page 460 for information on obtaining the external trace 
output. 


You can use the VSCS QUERY command to display: 


e What traces are active 

e Which logical units are being traced (if selective tracing is used) 

e Modes of tracing, for example, external and individual LU trace tables 
e The location of the internal trace table (if it is allocated). 
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Using the External VSCS Traces 
To collect trace data from the VSCS trace running in external mode, you must: 
1, Set up operating system utilities to collect the trace information. 
2. Run the VSCS trace in external mode. 
3. Stop the VSCS trace to quit collecting the information. 
4. Stop running the operating system utilities that collect the information. 
5. Format and print the trace information. 


This section describes how to run and stop the VSCS trace in external mode. 


To run the VSCS traces externally, issue the following commands from the VSCS 

console: 

VSCS TRACEON (EXT ALL EXT means run the trace externally. ALL means turn on 
the CCS, data, dispatcher, FRE, GET, and VTAM exit 
trace options. 

VSCS TRACEON netid./uname 
This is required only for selective LU tracing. 


VSCS trace output is sent to a spool file. 


When you have collected enough data and you want to stop VSCS tracing, issue 
the following commands from the VSCS console: 


VSCS TRACEOFF (EXT Turn off external tracing. 
VSCS TRACEOFF (ALL Turn off all VSCS trace options. 


To start or change the current VSCS trace options after issuing the TRACEOFF 
command or to switch from selective to non-selective tracing, use the following: 


YSCS TRACEON * Turn on non-selective tracing. This command is needed 
! only if you used selective tracing earlier. 


VSCS TRACEON (CCS VYTAM Activate the CCS and VTAM trace options, and use the 
internal global trace table. You should use this minimum 
trace at all times. 


See “Collecting External Trace Data (VM)” on page 359 for information on using 
operating system utilities to collect, format, and print VSCS trace information. 


VSCS Trace Table 
VSCS records the data in a global internal table that wraps around when full. The 
size of the trace table, up to 64000 entries, is specified during VSCS initialization. 
The default size is 2000 records of 32 bytes each. 


Storage for the global VSCS trace table is not allocated until the trace is activated 
and tracing begins. When the trace facility is turned off, storage for the global 
VSCS trace tabie is preserved and can be dumped by the operator using the CP 
VMDUMP FORMAT command. 


The VSCS QUERY command gives the starting address, ending address, and size 


of the global VSCS trace table. In addition, the global VSCS trace table can be 
found through a pointer at SABTRHDR in the DTISAB. 
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Trace Table Header 
The VSCS trace table contains a header record (DTITHDR) followed by the trace 
records (DTITREC). Figure 74 shows the trace table header. 


oe [te ater ot eres 
: 
: 
: 
: 
; sane — 
Zero 

iC 

. 
; 
: 
34 ; 

38 Zero | 
3C | 


Figure 74. VSCS Trace Header Format 


The header shows this information: 


Byte (hex) Contents 
00-01 DTITHDR element header (TR) 


02-03 Number of entries in table 

04—08 Zero 

08—0B Pointer to current entry in table 

OC—OF Pointer to first entry in table 

10-13 Pointer to last entry in table 

14-17 Address to be used in freeing the trace table storage 


18-1F Zero 

20—23 Address of DTIISDA1 
24-27 Address of DTIISDA2 
28-2B Address of DTIISTRT 
2C—2F Address of DTIIPATCH 
30-33 Address of DTIIPARM 
34-—3F Zero. 
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Examples of VSCS Trace Output 


Following are three ways to look at the VSCS global trace table: 

e Online at the VSCS operator console 

e In dump output 

e If produced in external mode, formatted with the TRACERED utility. 
To view the global trace table online, issue the VM DISPLAY command from the 
VSCS operator console. Figure 75 on page 463 is an example of DISPLAY 


output. (The trace record titles do not appear in actual output; they are in the 
example to identify the different trace entry types.) 


Figure 76 on page 464 shows what the trace table looks like in dump output. (The 
trace record titles and the frames around the output do not appear in actual output. 
They are added to the examples to identify the different trace entry types.) 


Figure 77 on page 465 shows an example of a VSCS trace running externally and 
formatted with TRACERED. 


To determine what book describes the VM DISPLAY command and the TRAC- 
ERED utility, see Table 80 on page 1165. 
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Storage 
Address 


265020 
265030 
265040 
265050 


265120 
265130 


265200 
265210 
265220 
265230 


265320 
265330 
265340 
265350 


2653E0 
2653F0 
265400 
265410 
265480 
265490 
2654A0 
2654B0 


265860 
265870 
2658A0 
2658B0 


265140 
265150 
265160 
265170 


266060 
266070 
266240 
266250 


266BE0 
266BFO 


Figure 


Trace header 


E3D97F58 
00363B40 
002221F8 
00220688 


VSCS CCS 
C3D5C3E3 
40404040 


VSCS CCS 
00213988 
0CQ00000 
QO00CE98 
0E000000 


00000000 00265580 


00265008 
0025E588 
00000000 


00000000 
0021F000 
00000000 


data trace entry 


00012000 


00060000 


05010000 00000006 


global trace entries 


Q0000001 C7D3C2D3 
00110000 00000000 
00000001 C7D3C2D3 
00010008 00000000 


VSCS VTAM exit trace entries 


E5D3D6C7 
00000000 
E7D3D6C7 
00000000 


VSCS dispatcher trace entries 


D7020000 
80000000 
E9000000 
00000000 
E5030000 
81000080 
E9000000 
00000000 


VSCS CCS 
00210E10 
01000001 
002 10E68 
QE000000 


00367A98 
00000000 
80000000 
00000000 


00367A98 
00000000 
00100000 
00000000 
00367A98 
00000000 
00100000 
00000000 


00367C58 
10000000 
00000000 
00000000 


Q036FF18 
00000000 
00000000 
00000000 
00375A40 
00000000 
00000000 
00000000 


LU trace entries 


00020000 
00020000 
00020000 
00040000 


VSCS Storage trace 
C6D9C5C2 002290D0 
01000000 6024F41C 
C7C5E3C2 00229300 
004C0100 502384A0 


01000002 
00000000 
01000002 
00000000 


entries 
QOOOCECO 
50250828 
0021A940 
60236A92 


00265040 
00000000 
00263BA8 
00000000 


5CC3C3E2 
40404040 


D9010228 
C8C9D5C5 
F1000008 
E5E3C1D4 


00000000 
00000005 
00000000 
00000000 


07040000 
E2C9D5E3 
01000002 
00000000 
10040000 
E2C5D5C4 
01000002 
00000000 


F2830009 
40020040 
C3830002 
00070000 


E2C4C9D5 
00000000 
Q005E000 
C5D5C1C2 


VSCS input and output data records 


D6010000 
00000000 
C9040400 
60115B60 


00219B68 00275DA8 
00000000 00000000 
00219B68 0021AD18 
00000000 0000000 


VSCS cleanup trace 
D7D9C2D2 00219868 
00000200 20000000 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


entry 
00840000 
01000002 


00000000 
00000000 
00067D5B 
00000000 


80000000 
00270DF0 


Chapter 11. Using VSCS Service Aids (VM) 


VSCS Trace Facility 


MR alexa bares & * 
Re anee Ties Rie descuenes * 
Rose Oe NV gla OibG 4 * 
* @eeeoe@ee5ueoee2051osve8ke8 @ * 
1 0 | 0 *CCS* 
* eee0ne3408ee * 
Ro Sern aie iets GLBLR...* 
Cereus s HINE* 
ee ae GLBL1...* 
is tsa vaio ute ave VTAM* 
*VLOG..:... Oe 5565 * 
* eseee eeoeecsceeee#ee#e#¢s¢# * 
RR COG 2 aie e se ewwes * 
* @eeeeeee#eeoe#u#9##e#e#8s# * 
RP cctogie ek eas * 
Moan Odie es SINT* 
® Lobe wea ete navies * 
* eese0aeeneeeoee545estee#e#8s#6 * 
| arene, ee eee Se * 
ce ee ne ee SEND* 
ee ee eee * 
* eeeoeeeeseees#see#4estd8 4 @ * 
* @eee0e7e5ses#8e@#8e0e 98 2% 
* @eeeesees#es8e#teste @@ * 
Rica each metered Cea * 
* @eeoseeeaeseeoeeeenseeoee * 
*FREB. wc cee ee SDIN* 
ee. ereeeeree * 
MGR TB cece tee y--o ee * 
*.<..8...-...ENAB* 
Onasch his Viciuters * 
* @eeeeesee3e##steeoeeetkes# este * 
Wtf errgra alana aes '$x 
*-.$- oeoeeeweroeoee * 
FPRBK io ace eduewds * 
eS a ieee cca erin Geta chs Q« 
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S66L ‘v86l ‘di0D Wal JUBUAdOD © 10-S900-E7A7 


sisoubelqd ZHvA WVLA 89h 


jndino duing ul spsovay e281, SOSA ‘9zZ eunbig 


STORAGE 
ADDR 


265020 
265040 


265120 


265200 
265220 


265320 
265340 


2653E0 
265400 
265480 
2654A0 


265860 
2658A0 


265140 
265160 


266060 
266240 


266BE0 


Trace header 


1 £3D97F58 00000000 00265580 00265040 00363840 00265008 00000000 


{ 002221F8 0025E588 0021F000 00263BA8 00220688 00000000 00000000 


vSCS CCS data trace entry 


C3D5C3E3 00012000 00060000 SCC3C3E2 40404040 05010000 00000008 


VSCS CCS global trace entries 

00213988 00000001 C7D3C2D3 D9ID1I0288 OCONO0000 00110000 00000000 
OOOOCE98 00000001 C7D3C2D3 F1000008 OEFN0D000 00010000 00000000 
VSCS VTAM exit trace entries 

E5D3D6C7 00367A98 000367C58 00000000 00000000 00000000 10000000 
E7D3D6C7 80000000 00000000 00000000 00000000 00000000 00000000 
VSCS dispatcher trace entries 

D7020000 00367A98 OO36FFI8 07040000 80000000 o0000000 00000000 
E9000000 00100000 00000000 01000002 O0000000 00000000 00000000 


E5030000 00367A98 00375A40 10040000 81000080 00000000 00000000 
E9000000 00100000 00000000 01000002 00000000 00000000 00000000 


VSCS CCS lu trace entries 


00210E£10 00020000 01000002 F2830009 01000001 00020000 00000000 


00210E68 00020000 01000002 CE8&30002 DEDDDDDN 00040000 00000000 


VSCS Storage trace entries 


C6D9C5C2 002290D0 OOOOCECO E2C4C9DS5 01000000 6024F41C 50250828 
C7CH5E3C2 00229300 0021A940 OO05E000 004C0100 502384A0 60236A92 


VSCS input and output data entries 


D6010000 00219868 00275DA8 00000000 00000000 00000000 00000000 
C9040400 00219B68 0021AD18 00067D5B 60115860 00000000 00000000 


VSCS cleanup trace entry 


00000000 


00000000 


40404040 


C8C9DSCS 


ESE3C1D4 


00000005 
00000000 


E2C9D5E3 
00000000 
E2C5D5C4 
00000000 


40020040 


00070000 


00000000 
C§D5C1C2 


00000000 
00000000 


+ te 8» ¥ 8 


Ct | 


| 


vo oe 8 ee wv 


ce ee | 


js ey 


a ye Bw be ee ee oF 


Wal jo Auedosg — sjeueyeyy posusory 


sNGI JO SFELSJEWy PSPUISEY,, 


Ayjoe4 soe) SOSA 
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3D OE VSCS3 VM/GCS USER REQUESTED GTRACE 
TIME OF DAY CLOCK = A1F762AA98968A01 
LENGTH OF GTF HEADER AND TRACE DATA = 0058 
FORMAT ROUTINE ID = F5 
EVENT IDENTIFICATION = EFAA 
VOPN TAB 0154F028 RPL O154F1E8 RPLREQ 17 RIN CODE 00 NAU 0002 RPLFDBK 0000 RPLSENS 0000 
VS STATE 00 VLBERFLG 00 PATHID 0000 VLBSWAP 10 00 00 00 VLBLRCD 0@ EXIT DATA 17 07 02 
XOPN PS STATE 80 PLB- SM 00 00 00 00 OFLG1 00 NOM 00 00 EDIT 00 IAFLG 00 ODFLG1 00 
RSVD 00 00000000 90000000 90000000 00000000 
3D OE VSCS3 VM/GCS USER REQUESTED GTRACE 
TIME OF DAY CLOCK = A1F762AA98AA5E01 
LENGTH OF GTF HEADER AND TRACE DATA = 0058 
FORMAT ROUTINE ID = F5 
EVENT IDENTIFICATION = EFAA 
PDISP LBCSTTUS 02 RSVD 0000 TAB 0154F028 WEB 01554008 WEBFUN 07 WEBMODE 04 WEBVSRPS 00 RSVD 00 
PS STATE 80 PLB- SM 00 00 00 00 OFLG1 00 NOM 00 00 EDIT 00 IAFLG 00 DFLG1 00 RSVD 00 MODULE SINT 
ZDISP RSVD 00 PATHID 0000 VS STATE 00 VLBSWAP 10 00 00 00 VLBERFLG 00 VLBLRCD 00 VLBERCVY 00 
CID 01000002 RSVD 00000000 00000000 00000000 00000000 
3D OE VSCS3 VM/GCS USER REQUESTED GTRACE 
TIME OF DAY CLOCK = A1F762B0647F1001 
LENGTH OF GTF HEADER AND TRACE DATA = 0038 
FORMAT ROUTINE ID = F5 
EVENT IDENTIFICATION = EFAA 
CCS WEB 01553028 PATHID 0002 0000 CID 01000002 TYPE 2 PS STATE 83 WEBCOUNT 0009 WEBFUN 01 WEBMODE 00 
WEB- CHAR 00 EDIT 01 FLAGS 00 02 LINE 0000 CURSR 0000 TABCH 00 RSVSA 00 DATA 40020050 * .. * 


Figure 77. VSCS Trace Records Formatted with TRACERED 


Note: To determine what book describes how to interpret “time of day clock” 
entries in trace output, see Table 80 on page 1165. 


VSCS Trace Record Formats 


The following list contains all VSCS trace entries, as well as LBCSTATE values for 
PLBINxxx and WEB function codes. For detailed descriptions, see the page indi- 
cated. 


e “VSCS CCS Trace Record Formats” on page 467 
— “CCS Trace Entry for a Logical Unit” on page 467 
— “Global CCS Trace Entry” on page 470 
— “CCS Data Trace Entries” on page 472 


- “ACNT Entry” on page 472 

- “CMSG Entry” on page 473 
- “CNCT Entry” on page 474 

- “GMSG Entry” on page 476 
- “LIER Entry” on page 477 

- “SCNT Entry” on page 477 

- “SEVR Entry” on page 478 


e “VSCS Cleanup Error Trace Record Formats” on page 478 
— “Logical Unit-Related Trace Entry (VPUR or PBRK)” on page 478 
— “Cleanup Module-Dependent Data” on page 481 


- “DTIPRBRK (ID='PBRK’)” on page 481 
“DTIVPURG (ID='VPUR’)” on page 482 


— “Logical Unit-Related Trace Entry (PFOR)” on page 483 
— “Data-Related Error Trace Entry (CXIT)” on page 486 
— “ABEND Trace Entry (ABND)” on page 488 
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— “Internal Error Trace Entry (INTR)” on page 489 
— “Module trace flow indicators” on page 490 


- “DTIPRBRK” on page 490 
- “DTIVPURG” on page 490 


e “VSCS Data Trace Record Formats” on page 491 


— “Input Trace Entry” on page 491 
— “Output Trace Entry” on page 491 


e “VSCS Dispatcher Trace Record Formats” on page 492 
— “Dispatcher Trace Entry for a Logical Unit: Entry 1” on page 492 
-— “Dispatcher Trace Entry for a Logical Unit: Entry 2” on page 495 
— “Dispatcher Trace Entry for a Global Connection” on page 497 

e “VSCS Operator Trace Record Formats” on page 500 

e “VSCS Storage Statistics Trace Record Format” on page 502 

e “VSCS Storage Trace Record Formats” on page 506 


~— “FREB Trace Entry” on page 506 
— “GETB Trace Entry” on page 507 


e “VSCS VTAM Exit Trace Record Formats” on page 507 


— “VSCS VTAM Exit Trace: Entry 1” on page 508 
— “VTAM Exit Module-Dependent Data” on page 510 
- “DTIVCLSX” on page 510 
- “DTIVDFAX” on page 510 
- “DTIVLOGX’ on page 511 
- “DTIVNSEX” on page 511 
- “DTIVOPNX” on page 511 
- “DTIVRECX” on page 511 
- “DTIVRESX” on page 513 
- “DTIVRLQX” on page 514 
- “DTIVSCIX” on page 514 
- “DTIVSNDX” on page 514 
- “VSCS VTAM Exit Trace: Entry 2” on page 515 
— “VTAM Exit Data Trace Entries” on page 519 
- “DTIVCLSX” on page 519 
- “DTIVDFAX” on page 519 
- “DTIVLOGX” on page 520 
- “DTIVLOSX” on page 521 
- “DTIVNSEX” on page 521 
- “DTIVOPNX” on page 522 
- “DTIVTPNX” on page 523 
- “DTIVRECX” on page 524 
- “DTIVRESX” on page 525 
- “DTIVSNDX” on page 526 
- “DTIVSCIX” on page 528 
— “DTIVSEND: Entry 1” on page 528 
— “DTIVSEND: Entry 2” on page 532 
— “DTIVSIML” on page 534 


e “LBCSTATE Values for PLBINxxx” on page 535 
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— “Console Mode” on page 535 

— “CMS Edit Mode” on page 535 

— “Full-Screen Support Mode (FSSM)” on page 535 
— “Internal Modes” on page 535 


e “WEB Function Codes” on page 535 
— “Function Codes for Internal States” on page 536 
— “Function Codes for Inbound Processing in All Modes” on page 537 
— “Function Codes for Outbound Processing in Console Mode” on page 537 
— “Function Codes for Outbound Processing in CMS Mode” on page 538 


— “Function Codes for Outbound Processing in Full-Screen Mode” on 
page 538. 


VSCS CCS Trace Record Formats 


When the CCS trace option is active, VSCS traces all traffic to and from CCS. 
However, you can limit the CCS trace to a selected set of logical units when you 
start it. The CCS trace produces three types of record formats: 


e Logical unit-related for traffic associated with logical units 
¢ Global for traffic not associated with a logical unit 
e Data for traffic associated with logical units or global traffic. 


CCS Trace Entry for a Logical Unit 


S 
. 
. 
: 
: 
? 
: 
Displacement: 


00-03 Address of DTIWEB associated with this request or response 
04-07 Path ID from communication services local block (CLB) 


04-05 VSCS path ID 
06-07 CCS path ID 
08-O0B VTAM communication identifier (CID), either OAF or DAF 


OC Flow indicator Flow direction 
R (Receive) CCS => VSCS (outbound) 
Y (REPLY) VSCS => CCS (inbound) 
1 (1-way SEND) VSCS => CCS (inbound) 
2 (2-way SEND) VSCS => CCS (inbound) 
T (Reject) VSCS => CCS (inbound) 
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0D 


OE-OF 
10 


11 


13 


“Restricted Materials of IBM” 
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C (Message complete) CCS => VSCS (outbound) 


Note: In this book, whenever a flow is referred to as inbound or out- 

bound, you should take the console communications services (CCS) 

as the reference point. That is, flows toward the CCS are inbound; 

flows away from the CCS are outbound. 

LBCSTATE from PLB : 

Ts eias< casgre LBCINT Internal mode if on (on=1). If LBCINT is 
on, see “LBCSTATE Values for 
PLBINxxx” on page 535. If LBCINT is 
off, the following values apply: 


sl he anaes LBCFSSMF  Full-screen support mode flags 
es bong aeee LBCFSAV Screen available 
Prd Remercee LBCFSII Full-screen input inhibited 


Description of settings for LBCFSSMF: 


B'00' CP (console) mode 

B'01' Virtual machine mode state 
between ATTN and READ, 
queue CP messages. 

B'10' Virtual machine mode queue 
CP messages. | 

B'11' Virtual machine mode available 


for switch. 
oo eer LBCCOPY Copy mode: on=1 
ee ee LBCNAL NAL flag: on=1 
Kei code LBCHOLD HOLDING flag: on=B'11' 
Jags LBCM10 MORE 10 flag: on=1 


odin, Saks LBCM50 MORE 50 flag: on=1 
ecnane. eee 1 LBCCMSD _ Screen written with a CMS DIAGNOSE: 
on=1 

shes: etek No MORE/HOLDING state 

WEBCOUNT Length of actual data in WEBDATA 

WEBFUN WEB function code. This is explained in “WEB Func- 
tion Codes” on page 535. 

WEBMODE Mode: 


00 Console 
01 CMS 
O02 Full-screen 
04 Internal 
WEBCHAR _ _ Character set (set by CCS for console and CMS 
modes) 


0O EBCDIC character set 
01 APL character set 
02 TEXT character set 

04 DBCS character set 

05 DBCS and APL character set 

06 DBCS and TEXT character set 
WEBEDIT Editing characteristics 
DL eihs= dees WEBIMMED Mode switch immediately 
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14 WEBFLAGS 


15 WEBCPFLG 
15 WEBSAFLG 


16-17 WEBLINE 


16 WEBLAID 
17 WEBNLLOS 
18-19 


1A WEBTABCH 
1B WEBRSVSA 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


WEBCURSR 


WEBPETCM 
WEBCLRSC 


WEBHIEKO 
WEBEDPTI 
WEBNOEKO 
WEBEDCUP 


WEBTTYWT 
WEBCLVMI 
WEBCONMD 
WEBLED 
WEBANFSW 


WEBDIAL 
WEBNOMOR 


WEBPRMPT 
WEBPASPA 


VSCS CCS Trace 


‘PRESS ENTER TO CONTINUE’ 
message 

CP clear screen 

Zero 

Highlight input display 

Do not print or do not display 

Do not redisplay input on next output line 
Convert to uppercase 


TTY/TWX WRITE when a READ is 
pending. Reject READ. 

Cancel all VM Reads and Writes for a 
display 

Request for display in CONMODE 3270 
Limited edit diagnose 

Allow any full-screen WRITE; first full- 
screen WRITE after reset. 

SNA dialed logical unit 

CMS ERASE WRITE no “MORE” 
requested 

WEBDATA contains pre-logon prompt 
Pass PA1 (FSSM) as data to application 


CCS status flags for VSCS 
VSCS status flags 


WEBCPNCR 
WEBCPPRI 
WEBCPALM 
WEBSAHLD 
WEBCPMDE 
WEBSAMOR 
WEBCPHLW 
WEBCPRSP 
WEBSARSP 
WEBCPRRR 
WEBSARRR 
WEBCPRNR 
WEBSARNR 


No carriage return (hard-copy terminal) 
Priority flag 

Ring the alarm 

HOLDING 

CP-generated bit = 1 

MORE VM-generated bit = 0 
Highlight WRITE requested 

Indicates CCS response 

Indicates VSCS response 

CCS request, requires response 
VSCS request, requires response 
CCS request, requires no response 
VSCS request, requires no response 


Line number for CMS WEBCMWRT 

Logical attention identifier 

Number of lines left on screen 

Cursor position may be a relative address or a buffer 


address 


Tab (not DTITAB) character 


Reserved 


WEBCPRDS 


WEBNOVCK 
WEBATTNW 
WEBINLIP 


DTIWEB is a redisplay DTIWEB 

Do not validity check data 

Attention WRITE (VSCS only) yes = 1 
Logon in progress 
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re oe Zero 
dele WEBCHDIR Change Direction required 
sierds WEBMASKW WRITE inhibit mask 
Side aes x Zero 
1C-—1F WEBDATA _ First four bytes of data field 


Note: This field is valid only if WEBCOUNT > 0. 


Global CCS Trace Entry 


A global entry occurs if CCS receives a request for a path ID that has been 


severed. 
: 
o 
: 
: 
: 
” 
: 
: 

Displacement: 


00-03 Address of DTIWEB associated with this request or response 
04-07 Path ID (from CLB) 


04-05 VSCS path ID 
06-07 CCS path ID 
08—-OB Characters ‘GLBL’ 


oC Flow indicator Flow direction 
R (Receive) CCS => VSCS 
Y (REPLY) VSCS => CCS 
1 (1-way SEND) VSCS => CCS 
2 (2-way SEND) VSCS => CCS 
T (Reject) VSCS => CCS 


C (Message complete) CCS => VSCS 
OD WEBCAN Number of control areas 
OE-OF WEBCOUNT Length of actual data in WEBDATA 
10 WEBFUN WEB function code. This is explained in “WEB Func- 
tion Codes” on page 535. 
11 WEBMODE_ Mode: 


00 Console 
01 CMS 

02 Full-screen 
04 Internal 
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12 WEBCHAR 
13 WEBEDIT 
Vetacen Sorbets 
has 
hls 
Kae 
jc Dees 
giles 
ee 
gibi ees be 1 
14 WEBFLAGS 
Lai. ee 
Dee eau 
obs 
ne ee 
ae ee 
re ree 
i ere 
Sade 
saraig: ane 1 
15 WEBSAFLG 


16-17 WEBLINE 
16 WEBLAID 
17 WEBNLLOS 
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VSCS CCS Trace 


Character set (set by CCS for console and CMS 


modes) 


00 
01 
02 
04 
05 
06 


EBCDIC character set 

APL character set 

TEXT character set 

DBCS character set 

DBCS and APL character set 
DBCS and TEXT character set 


Editing characteristics 


WEBIMMED 
WEBPETCM 


WEBCLRSC 
WEBHIEKO 
WEBEDPTI 
WEBNOEKO 
WEBEDCUP 
WEBTTYWT 
WEBCLVMI 
WEBCONMD 
WEBLED 
WEBANFSW 


WEBDIAL 
WEBNOMOR 


WEBPRMPT 
WEBPASPA 


Mode switch immediately 

‘PRESS ENTER TO CONTINUE' 
message 

CP clear screen 

Zero 

Highlight input display 

Do not print or do not display 

Do not redisplay input on next output line 
Convert to upper case 


TTY/TWX WRITE when a READ is 
pending. Reject READ. 

Cancel all VM Reads and Writes for a 
display 

Request for display in CONMODE 3270 
Limited edit diagnose 

Allow any full-screen WRITE; first full- 
screen WRITE after reset. 

SNA dialed logical unit 

CMS ERASE or WRITE no "MORE" 
requested 

WEBDATA contains pre-logon prompt 
PA1 (FSSM) pass as data to application 


VSCS status flags 


WEBCPNCR 
WEBCPPRI 
WEBCPALM 
WEBSAHLD 
WEBCPMDE 
WEBSAMOR 
WEBCPHLW 
WEBCPRSP 
WEBSARSP 
WEBCPRRR 
WEBSARRR 
WEBCPRNR 
WEBSARNR 


No carriage return (hard-copy terminal) 
Priority flag 

Ring the alarm 

HOLDING 

CP-generated bit = 1 

MORE VM-generated bit = 0 
Highlight WRITE requested 
Indicates CCS response 

Indicates VSCS response 

CCS request, requires response 
VSCS request, requires response 
CCS request, requires no response 
VSCS request, requires no response 


Line number for CMS WEBCMWRT 
Logical attention identifier 
Number of lines left on screen 
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18-19 


1A 
1B 


1C-1F 


CCS Data Trace Entries 
0 4 
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WEBCURSR Cursor position may be a relative address or a buffer 
. address 
WEBTABCH Tab (not DTITAB) character 
WEBRSVSA_ Reserved 
Discs ieee WEBCPRDS _DTIWEB is a redisplay DTIWEB 
a Ahite: Secbrat WEBNOVCK Do not validity check data 
aula. tees WEBATTNW Attention WRITE (VSCS only) yes = 1 
ede aired WEBINLIP — Logon in progress 
ae oo Zero 
Seles WEBCHDIR- Change Direction required 
vats WEBMASKW WRITE inhibit mask 

Ned? we Xx Zero 
WEBDATA _ First four bytes of data field 


Note: This field is valid only if WEBCOUNT > 0. 


1F 
// 
// 
Displacement: 
00-03 Header 
‘ACNT’ Accept connection CCS => VSCS 
‘CMSG’ Completion of a 1-way SEND CCS => VSCS 
‘CNCT’ Connect VSCS => CCS 
‘GMSG’ Ignored traffic on global path CCS => VSCS 
‘LIER’ Logical interface error CCS => VSCS 
‘SCNT’ Request to SEVER connection CCS => VSCS 
‘SEVR’ Connection severed VSCS => CCS 
or 
CCS => VSCS 
04-1F First 28 bytes of data from area passed 


ACNT Entry: Accept connection, CCS => VSCS 


6) 4 8 C 1F 
'ACNT' |Module of te IUCV parameter list 


Displacement: 


00-03 
04-07 


08—0B 
0C-0D 
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Characters ‘ACNT’ 

Last four characters of module making trace entry. First four charac- 
ters are always DTIP. 

Zero 

Path ID 
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OE 


OF 
10-11 
12-13 
14-15 
14 


15 


16-17 
18-1B 


IPFLAGS1 


IPSMGLIM 
Zero 
IPAUDIT 
IPAUDIT1 


User data 


IPALL 
IPQUSCE 
IPPRTY 
IPNORPY 
IPCPENTY 
IPFGMID 
IPFGPID 
IPFGMCL 


VSCS CCS Trace 


QUIESCE, RESUME, and SEVER ALL 
Connect in QUIESCE mode 

Priority message, REPLY required 
One-way protocol 

Entry from CP 

Message ID specified 

Path ID specified 

Message class specified 


External interrupt code 


Message limit 


Audit trail as follows: 
Audit trail byte 1 


IPADRPLE 
IPADSNPX 
IPADSNAX 
IPADANPX 
IPADANAX 
IPADRJCT 


REPLY too long for buffer 

Protection exception on SEND buffer 
Address exception on SEND buffer 
Protection exception on ANSWER buffer 
Address exception on ANSWER buffer 
Message was rejected 

Zero 


Audit trail byte 2 


IPADRCPX 
IPADRCAX 
IPADRPPX 
IPADRPAX 
IPADSVRD 


Protection exception on RECEIVE buffer 
Address exception on RECEIVE buffer 
Protection exception on REPLY buffer 
Address exception on REPLY buffer 
Path was severed 

Zero 


1C-1F First four bytes of logical unit name 


CMSG Entry: Completion of a one-way send, CCS => VSCS 


0 4 


8 


C 


1F 


IUCV parameter list 


Displacement: 


00-03 
04-07 


08—0B 
0C—0D 
OE 


Characters ‘CMSG’ 
Last four characters of module making trace entry. First four charac- 
ters are always DTIP. 


Zero 
Path ID 
IPFLAGS1 
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IPALL 
IPQUSCE 
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QUIESCE, RESUME, and SEVER ALL 
Connect in QUIESCE mode 
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OF 
10-13 
14-17 
14-15 
14 


15 


16-17 
18-1B 
1C-1D 
1E-1F 


IPMSGID 
IPTRGCLS 
IPAUDIT 
IPAUDIT 1 


IPBFADR1 


IPBFLN1 


IPPRTY 
IPNORPY 
IPCPENTY 
IPFGMID 
IPFGPID 
IPFGMCL 
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Priority message, REPLY required 
One-way protocol 

Entry from CP 

Message ID specified 

Path ID specified 

Message class specified 


External interrupt code 


Message ID 
Target class 


Audit trail as follows: 
Audit trail byte 1 


IPADRPLE 
IPADSNPX 
IPADSNAX 
IPADANPX 
IPADANAX 
IPADRJCT 


REPLY too long for buffer 

Protection exception on SEND buffer 
Address exception on SEND buffer 
Protection exception on ANSWER buffer 
Address exception on ANSWER buffer 
Message was rejected 

Zero 


Audit trail byte 2 


IPADRCPX 
IPADRCAX 
IPADRPPX 
IPADRPAX 
IPADSVRD 


Zero 


Protection exception on RECEIVE buffer 
Address exception on RECEIVE buffer 
Protection exception on REPLY buffer 
Address exception on REPLY buffer 
Path was severed 

Zero 


Address of buffer 1 


Zero 


Length of buffer 1 


CNCT Entry: Request for connection, VSCS => CCS 


0 4 


IUCV parameter list 


1F 


Characters ‘CNCT’ 


Displacement: 
00-03 
04-05 Path ID 
06 IPFLAGS1 
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IPALL 
IPQUSCE 
IPPRTY 
IPNORPY 
IPCPENTY 
IPFGMID 
IPFGPID 


QUIESCE, RESUME, and SEVER ALL 
Connect in QUIESCE mode 

Priority message, REPLY required 
One-way protocol 

Entry from CP 

Message ID specified 

Path ID specified 
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eee: kk 1 IPFGMCL Message class specified 
07 IPRCODE Return code 
08-09 IPSMGLIM Message limit 
OA IPFCNCD Function code 
OB Zero 
OC-13 IPVMID Target virtual machine ID 
14-1B “CCS’ (These characters will be left-justified in the eight-byte 
field.) 


1C-1F First four bytes of logical unit name 
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GMSG Entry: Traffic on global path is ignored, CCS => VSCS 


) 4 


1C 1F 


'GMSG' |Bytes 0-23 of external parameter list 


Displacement: 
00-03 Characters ‘GMSG’ 
04-05 Path ID 
06 IPFLAGS1 
Dette Silica IPALL QUIESCE, RESUME, and SEVER ALL 
7 eee IPQUSCE Connect in QUIESCE mode 
sale & IPPRTY _ Priority message, REPLY required 
ey eee IPNORPY One-way protocol 
oe ee IPCPENTY _— Entry from CP 
desis IPFGMID Message ID specified 
ae IPFGPID Path ID specified 
vine. wae 1 IPFG@GMCL Message class specified 
07 IPTYPE External interrupt code 
08-OB IPMSGID Message ID 
OC-OF IPTRGCLS _ Target class 
OC-—OD IPAUDIT Audit trail as follows: 
OC IPAUDIT 1 Audit trail byte 1 
dL srauae, Oe IPADRPLE — REPLY too long for buffer 
whe IPADSNPX Protection exception on SEND buffer 
Gealliee. 3d IPADSNAX Address exception on SEND buffer 
ere IPADANPX Protection exception on ANSWER buffer 
Pee rear IPADANAX Address exception on ANSWER buffer 
oe ee IPADRJCT Message was rejected 
eeares 28 XX Zero 
OD IPAUDIT2 Audit trail byte 2 
Weis aia IPADRCPX Protection exception on RECEIVE buffer 
‘hes IPADRCAX Address exception on RECEIVE buffer 
ee oe IPADRPPX _ Protection exception on REPLY buffer 
nile ass IPADRPAX Address exception on REPLY buffer 
ep eee IPADSVRD sw Path was severed 
Peake XXX Zero 
OE—OF Zero 
10-13 IPBFADR1 Address of buffer 1 
14-15 Zero 
16-17 IPBFLN1 Length of buffer 1 
18-1B IPSRCCLS Source class 
1C—1F VEIB Address 
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LIER Entry: Logical interface error, CCS => VSCS 
Q 4 8 10 14 18 1F 


Last four | LU name DTITAB 
'LIER' char of with 


module logic err ADDR 


Displacement: 


00-03 Character ‘LIER’ 

04-07 Last four characters of module making trace entry. First four charac- 
ters are always DTIP. 

O8-—OF Logical unit name of device with logical interface error. 

10-13 Address of DTITAB 

14-17 Address of DTIWEB that was input to module making trace entry. 

18-1F Zero 


SCNT Entry: Request to SEVER connection, CCS => VSCS 
0 4 6 14 18 ~=61€ 1D 1F 
Address Reason 


of TAB 
'SCNT' or SAB 


or VM 
ctrl blk 


Displacement: 


00-03 Characters ‘SCNT’ 

04-05  I|D of path that is to be severed 

06-13 Zero 

14-17 Address of terminal anchor block (TAB), service application block 
(SAB), or VTAM control block 


18-1B Zero 
1C Reason code 
1 VSCS not enabled by CP 
2 Maximum logical unit limit exceeded 
3 No VSCS global CONNECT accepted 
4 VTAM service machine (VSM) not enabled 
5 Duplicate logical unit name found on VTAM service machine 


(VSM) RDEVBLOK chain 


6 This path ID is currently in use 

7 TAM service machine was previously connected 

8 Message limit exceeded 

9 VTAM service machine global path severed 
1D-1F Zero | 
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SEVR Entry: Connection severed, VSCS => CCS or CCS => VSCS 
4 


0 4 6 1 18 1F 
Path Address 
'SEVR' Zero of TAB Zero 
ID or SAB 


Displacement: 


00-03 Characters ‘SEVR’ 
04-05 ID of path that was severed 


06-13 Zero 
14-17 Address of TAB or SAB 
18-1F Zero 


VSCS Cleanup Error Trace Record Formats 


The VSCS cleanup trace is activated automatically if any of the other VSCS traces 
are active. The cleanup trace applies only to the set of logical units specified for 
the other VSCS traces. Normal session terminations and error situations are 
traced. Three kinds of cleanup trace records are produced: 


¢ Logical unit-related (VPUR, PBRK, or PFOR) 
e Data-related (associated with VSCS global path) (CXIT) 
e ABEND or internal errors (ABND or INTR). 


Logical Unit-Related Trace Entry (VPUR or PBRK) 


: 
: 
: 
: 
: 
: 
: 
: 

Displacement: 


00-03  Four-character module ID (characters “PBRK” or “VPUR”) 
04-07 TAB address for current request 


08 RPL request code 
09 LBCSTATE from PLB 
Die. hoses LBCINT Internal mode if on (on=1). If LBCINT is 
| on, see “LBCSTATE Values for 
PLBINxxx” on page 535. If LBCINT is 
off, the following values apply: 
=p Pero LBCFSSMF _ Full-screen support mode flags 
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sigia: learns LBCFSAV Screen available 
walls. qos LBCFSII Full-screen input inhibited 
Description of settings for LBCFSSMF: 
B'00' CP (console) MODE 
B'01' Virtual machine mode state 
between ATTN and READ, 
queue CP messages 
B'10' Virtual machine mode queue CP 
messages 
B'11' Virtual machine mode available 
for switch. 
ode eee LBCCOPY Copy mode: on=1 
wee. lee. ~~ LBCNAL NAL flag: on=1 
eee: el PE LBCHOLD HOLDING flag: on=B'11' 
ee LBCM10 MORE 10 flag: on=1 
a eceiae -2eeeles LBCM50 MORE 50 flag: on=1 
warts 2254 1 LBCCMSD _ Screen written with a CMS DIAGNOSE: 
on=1 
seein fo Wish No MORE/HOLDING state 
OA PLBFSSMF Full-Screen support mode flags 
Dedede seca PLBFPA1 PA1 key received switch mode 
es seasats PLBFSRFC Mode switch required (FSSM to console) 
eck aaiies PLBFSAFC = Switch available (FSSM to console) 
aad: eres PLBFCNMP Console message pending 
ae ae PLBFVSIP — VTAM services SEND in progress 
ee PLBFCLGF Conditional LOGOFF received 


eee e PLBFCMRR 

ieianer aes 1 PLBCMSEW 
OB PLBLFLG1 

Ded. -e.g.0 PLBVS 

a eee PLBLGFC 

are PLBLGFU 


oer PLBLERR 
ere PLBLLERR 


shies PLBLVERR 


wale PLBLSEVR 


gang aed 1 PLBNSTR 
le PLBFLG1 

Deets eieists PLBLGO 

i ere er PLBINAR 

eae -ewex PLBLFLNP 
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CP message pending, response require 
Screen just cleared | 


VTAM services LOGOFF received 
bypass logo 

WEBINLGEF sent to CCS conditional 
LOGOFF 

WEBINLGF sent to CCS unconditional 
LOGOFF 

WEBINERR sent to CCS for hard error 
WEBINLER sent to CCS for interface 
error 

WEBINVER sent to CCS for internal 
logic error 

CP CCS SEVER received, VSCS must 
SEVER 

No storage indicator in LOGOFF proc- 
essing 


Logo or no logo bit (logo = 1) 
APL or TEXT starting in input area 
LOGON from logo not permitted 
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OD-OE 
OD 


OE 


OF 


10 


11 


12 
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PLBNOM 
PLBNFLG1 


~XXX_ XXXX 
PLBOFLG1 


PLBCONCT 
PLBCNCTI 


PLBINREC 
PLBPRMPT 


PLBSDIAL 
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Current connect count incremented for 
logical unit 

IUCV CONNECT has been issued 
Input received during purge 

Usability prompt message flag. 


For display terminals: CP READ 
received but prompt not sent. 


For hard-copy terminals: VSCS sent 
prompt to logical unit. 
SNA-dialed logical unit 


Notify output manager 


NOM flag 1 
PLBCEND 
PLBRDTX 
PLBSAC 
PLBCLROA 
PLBCLRIA 
PLBRING 


PLBUNLK 
NOM flag 2 
PLBRDPND 


Command end (READ) 
Redisplay timer has expired 
Status area change required 
CLEAR output area 

CLEAR input area 

Ring the alarm 

Zero 

Unlock keyboard 


Redisplay pending 
Zero 


Output manager flags 


PLBSDIAG 
PLBPSMSG 
PLBOSRIP 
PLBOKLOK 
PLBOKPMI 


PLBOSWRT 
PLBOCRRQ 


PLBOEXRQ 


From VLB 
LBCVSST 


CMS DIAGNOSE on screen 

Priority message on screen 

SEND retry in progress 

Keyboard locked 

Hard-copy terminal mask input area sent 
CMS WRITE active (no input received) 
Carriage return required before SEND 
(on hard-copy terminal) 

“!” required before SEND (on hard-copy 
terminal) 


VTAM services state: 0 = Normal, 
1 = Termination 


LOGOFF reason codes 


VLBVTLO 
VLBVRYI 
VLBHLTQ — 
VLBHLTC 
VLBIOE 
VLBINERR 


VTAM LOGOFF 


~ VARY INACTIVE 


HALT QUICK 

HALT CANCEL 
Unrecoverable I/O error 
Internal error 

Zero 


WEBFUN code or zero (See “WEB Function Codes” on page 535.) 
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13 
14-17 


14 


15 


16 


17 


18-1B 
1C-1F 


Cleanup Module-Dependent Data 


TRCFLOW 
VLBSWAP 


VLBFLG 


~ XXXX 
VLBFLG1 


ecee «XXX 
VLBCID 
Address 


VSCS Cleanup Error Trace 


Cleanup-module-dependent data 


The following four bytes are the individual fields that 
make up VLBSWAP: 


VLB flags 
VLBBSPBB 
VLBBSPEB 
VLBBSINB 
VLBSR 


VLB flag 1 
VLBIOTR 


VLBCLSD 


VLBPCS 
VLBSIGNL 
VLBCHGD 
VLBRETR 
VLBRETS 
VLBSNDRD 
VLB flag 2 
VLBRPLB 
VLBCLPND 


VLBBUSY 
VLBNAV 
VLBOPCK 
VLBWAIT 


Bracket state - pending begin bracket 
Bracket state - pending end bracket 
Bracket state - in bracket 

Application SEND or RECEIVE state: 
1 = SEND state, 0 = RECEIVE state 
Zero 


Inbound data received since last SEND 
indicator 

CLSDST: O = required, 1 = not 
required 

Purging chain state 

SIGNAL sent 

Change Direction required 

Retry RECEIVE request 

Retry SEND request 

Active SEND is a Read (ER mode only) 


RPL in use 

VTAM CLSDST pending 
Zero 

Printer busy 

Printer not available 


Operation check occurred — 


Waiting for data or LUSTAT 


Special SEND indicator 


VLBCLR 
VLBSDT 
VLBCANC 
VLBSIGRQ 
VLBCHECK 


CLEAR required 

SDT required 
CANCEL required 
SIGNAL required 
Bypass CHECK macro 
Zero 


Network address pair (CID) 
DTIWEB if WEBFUN not zero, RPL if RPLREQ not 


Zero 


The trace flow flags are located at byte X'1C' of the cleanup error trace entries. 
The settings for these flags are as follows for each of the cleanup modules: 


DTIPRBRK (ID='PBRK’): 


01 
02 


TRXPURG 
TRXNWEB 
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No input WEB 


481 
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03 
04 


TRXLOGO 
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Logo error 


TRXCOND ~— Conditional LOGOFF 


DTIVPURG (ID='VPUR'): Trace flow flags are set as follows: 
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Schedule failed 
Storage shortage 
Space reserved for module flow indicator 


00 
01 
02 
03 
04 
05 


06 


07 


TRXNORM 


TRXNTERM 


TRXLTERM 
TRXWORK 
TRXNWORK 
TRXCONN 


TRXACTIV 


TRXIGNOR 


Normal cleanup 

NOTERM entered 

Logical unit in termination 

VSCS ignoring work to process request 
No work to process DTIVLOFF called 
Logical unit in termination state with CCS 
connection 

Logical unit state is not termination with 
no connection 

CCS has been notified or DTIPRBRK 
has set a timer to force purge. VSCS is 
waiting. 
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Logical Unit-Related Trace Entry (PFOR) 


: 
; 
. 
: 
10 VLBSWAP 
Bree ree 
TABLUNM | 
18 
: 


Displacement: 


00-03  Four-character module ID 
04-07 TAB address for current request 
08 LBCSTATE from PLB 
Dice. Sbiacs LBCINT Internal mode if on (on=1). If LBCINT is 
on, see “LBCSTATE Values for 
PLBINxxx” on page 535. If LBCINT is 
off, the following values apply: 
le ane LBCFSSMF  Full-screen support mode flags 
state? deaces LBCFSAV Screen available 
Pees mae LBCFSII Full-screen input inhibited 
Description of settings for LBCFSSMF: 


B'00' CP (console) mode 
B'01' Virtual machine mode state 
between ATTN and READ, 
queue CP messages 
B'10' Virtual machine mode queue 
CP messages 
B'11' Virtual machine mode available 
for switch. 
es ae LBCCOPY Copy mode: on=1 
sidean dees LBCNAL NAL flag: on=1 
ee oe LBCHOLD HOLDING flag: on=B'11' 
re oe LBCM10 MORE 10 flag: on=1 
area. Seale LBCM50 MORE 50 flag: on=1 
shee ah, tiee l LBCCMSD _ Screen written with a CMS DIAGNOSE: 
on=1 
setae eae No MORE/HOLDING state 


09 PLBLFLG1 
Leee-vaee PLBVS VTAM services LOGOFF received 
bypass logo 
er PLBLGFC WEBINLGEF sent to CCS conditional 
LOGOFF 
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Set ees PLBLGFU WEBINLGF sent to CCS unconditional 


LOGOFF 
ee eee PLBLERR WEBINERR sent to CCS for hard error 
. 1... PLBLLERR WEBINLER sent to CCS for interface 
error 
ne PLBLVERR WEBINVER sent to CCS for internal 
logic error | 
ie PLBLSEVR CP CCS SEVER received, VSCS must 
SEVER 
ee ee 1 PLBNSTR No storage indicator in LOGOFF proc- 
essing 
OA-OB PLBNOM Notify output manager 
0A PLBNFLG1 NOM flag 1 
eces. gerne PLBCEND Command end (READ) 
Sek ceckeaes PLBRDTX Redisplay timer has expired 
ides. weeds PLBSAC Status area change required 
Piel senate PLBCLROA CLEAR output area 
4g Abe PLBCLRIA CLEAR input area 
oy Ee PLBRING Ring the alarm 
aees js Zero 
Saki eats 1 PLBUNLK Unlock keyboard 
OB PLBOFLG1 Output manager flags 
Wisse. <aitene PLBSDIAG CMS DIAGNOSE on screen 
ere PLBPSMSG Priority message on screen 
pales aes PLBOSRIP SEND retry in progress 
re ee PLBOKLOK Keyboard locked 
ere ere PLBOKPMI _ Hard-copy terminal mask input area sent 
ee ae PLBOSWRT CMS WRITE active (no input received) 


elie PLBOCRRQ Carriage return required before SEND 
(on hard-copy terminal) 
Pentta ieery 1 PLBOEXRQ_ ‘“! required before SEND (on hard-copy 
terminal) 
oC TABDTYPE 


01 DTYPEDSP for a display 
02 DTYPEKP for a keyboard/printer 
03 DTYPEPRT for a printer 

OD TABDSUB 


01 VDEV3767 for a 3767 
02 VDEV2741 for a 2741 
03 VDEVTWX for a TWX/TTY/3101 
OE LBCSTATE VLB 
Hebe. ee l LBCVSST VTAM services state: 0 = Normal, 
1 = Termination 


OF VLBLRCD LOGOFF reason codes 
Wi acaseh aceea VLBVTLO VTAM LOGOFF 
lees Sees VLBVRYI VARY INACTIVE 
ee eee VLBHLTQ HALT QUICK 
ae err VLBHLTC HALT CANCEL 
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10-13 


10 


11 


12 


13 


VLBSWAP 


VLBFLG 


» XXXX 
VLBFLG1 


wees «XXX 
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VLBIOE 
VLBINERR 


Unrecoverable I/O error 
Internal error 
Zero 


The following four bytes are the individual fields that 
make up VLBSWAP: 


VLB flags 

VLBBSPBB _ Bracket state-pending begin bracket 

VLBBSPEB _ Bracket state-pending end bracket 

VLBBSINB _ Bracket state-in bracket 

VLBSR Application SEND or RECEIVE state: 
1 = SEND state, O = RECEIVE state 
Zero 

VLB flag 1 

VLBIOTR Inbound data received since last SEND 
indicator 

VLBCLSD CLSDST: O = required, 1 = not 
required 

VLBPCS Purging chain state 

VLBSIGNL SIGNAL sent 

VLBCHGD Change Direction required 

VLBRETR Retry RECEIVE request 

VLBRETS Retry SEND request 

VLBSNDRD Active SEND is a Read (ER mode only) 

VLB flag 2 

VLBRPLB RPL in use 

VLBCLPND VTAMCLSDST pending 
Zero 

VLBBUSY Printer busy 

VLBNAV Printer not available 

VLBOPCK Operation check occurred 

VLBWAIT Waiting for data or LUSTAT 

Special function flags 

VLBCLR CLEAR required 

VLBSDT SDT required 

VLBCANC CANCEL required 

VLBSIGRQ __— SIGNAL required 

VLBCHECK Bypass CHECK macro 


Zero 
Logical unit name being forced 
X'FF' to indicate data trace entry 
Module flow indicator 1 done by SPECIALX 
SPECIALX called 
CONECTYS called 
CONECTNO called 
COPYSIT called 
DTIPRCLP called 
DTIPRBRK called 
DTIPRSVR called 
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1F 
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fone vette 1 DTIPRLGF called 
Module flow indicator 2 done by SPECIALX 

i ee eee ere SPECIALX called 
eee CONECTYS called 
a ema CONECTNO called 
Ar eee COPYSIT called 

a or DTIPRCLP called 

ae Lech DTIPRBRK called 
ee DTIPRSVR called 
esters, (oe 1 DTIPRLGF called 

| Queue status indicators 


Lite as3% LUNORMAL Logical unit contro! blocks on normal 
queue | 

slits. ee ey LUREC Logical unit control blocks on recovery 
queue 


bites aot LUPQUEUE PS PIB on PS dispatcher queue 
eo ere LUVQUEUE VS PIB on VS dispatcher queue 


oe LUBFKPIB WEBCPBRK on PS PIB work queue 
a ee LUBRKLBC WEBCPBRK on LBC pending queue 
eds LUVSBRK = WEBVSBRK found on one of the work 
queues 
sees ABs 1 LUNTF60 WEBNTF60 found on PS PIB 


Data-Related Error Trace Entry (CXIT) 


00 
04 
08 
OC external 
10 parameter 
1B 
14 list mi 
18 
1C 
Displacement: 
00-03 Characters ‘CXIT’ 
04-05 Path ID 
06 IPFLAGS1 
Lise Sowa IPALL QUIESCE, RESUME, and SEVER ALL 
slsea. aireeha IPQUSCE Connect in QUIESCE mode 
are Comer a IPPRTY Priority message, REPLY required 
Sad eran IPNORPY One-way protocol 
cae rere IPCPENTY — Entry from CP 
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07 
08-0B 
OC-—OF 
0C-OD 
OC 


0D 


OE-OF 
10-13 
14-15 
16-17 
18-1A 
1B 


1C-1F VEIB address 


IPMSGID 
IPTRGCLS 
IPAUDIT 
IPAUDIT 1 


IPBFADR1 


IPBFLN1 
IPSRCCLS 


Module flow 
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IPFGMID 
IPFGPID 
IPFGMCL 


VSCS Cleanup Error Trace 


Message ID specified 
Path ID specified 
Message class specified 


External interrupt code 


Message ID 
Target class 


Audit trail as follows: 
Audit trail byte 1 


IPADRPLE 
IPADSNPX 
IPADSNAX 
IPADANPX 
IPADANAX 
IPADRJCT 


REPLY too long for buffer 

Protection exception on SEND buffer 
Address exception on SEND buffer 
Protection exception on ANSWER buffer 
Address exception on ANSWER buffer 
Message was rejected 

Zero 


Audit trail byte 2 


IPADRCPX 
IPADRCAX 
IPADRPPX 
IPADRPAX 
IPADSVRD 


zero 


Protection exception on RECEIVE buffer 
Address exception on RECEIVE buffer 
Protection exception on REPLY buffer 
Address exception on REPLY buffer 
Path was severed 

Zero 


Address of buffer 1 


Zero 


Length of buffer 1 
Source class 
(failure point) 


01 
02 


03 
04 
06 
07 
08 
09 
OA 
OB 


oC 


VSCS abnormal termination in progress 
Pending CONNECT received - not sup- 
ported 

Error dequeueing VEIB or no VEIBs 
received 

Error enqueueing VEIB on global message 
queue 

Enqueue or dequeue error found 

Schedule with priority failed 

Schedule failed 

No match found for path ID in path ID table 
Control block passed not a valid DTISAB or 
DTITAB 

Storage shortage obtaining additional 
VEIBs 

Storage shortage obtaining additional 
VEIBs 
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ABEND Trace Entry (ABND) 


© [ke 
08 
Failing PSW 
QC 
: 
: 
: 
Displacement: 
00-03 Characters “ABND” 
04-05 Task ID 
06-07 Abend code 
08-OF Failing PSW 
10-13 Address of SDWA 
14-17 Register 13 at time of failure 
18-1B DTITAB address or zeros 
1C Data record indicator X'FF' 
1D RTNCODE _ Return code from the module 
1E SABABIPF Abend in progress flags 
eee re SABPABIP _ Presentation services abend in progress 
pce. wee SABUABIP _ Utility services abend in progress 
..11 1111 Reserved 
1F Dump number 0-255 
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Internal Error Trace Entry (INTR) 


: 
. 
. 
: 
: 
: 
: 
: 

Displacement: 


00-03 Characters “INTR’” 

04-07 Occurrence value 

08-—OB __ Last four characters of module name 
OC-OF First caller's return address 

10-13 Second caller's return address 
14-17 Register 13 at time of failure 

18-1B DTITAB address or zeros 


1C Data record indicator X'FF' 

1D RTNCODE _ Return code from the module 

1E SABABIPF Abend in progress flags 
Lewd. eda SABPABIP Presentation services abend in progress 
Shak, Waar SABUABIP _ Utility services abend in progress 
..11 1111 Reserved 

1F ‘Dump number 0-255 
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Module trace flow indicators 
DTIPRBRK: The settings for these flags are as follows for each of the cleanup 


modules: 
00 TRXNORM — Normal cleanup 
01 TRXPURG Logical unit in PLBINPRG (88) state 
02 TRXNWEB __ No input WEB 
03 TRXLOGO _ Logo error 
04 TRXCOND ~~ Conditional LOGOFF 


DTIVPURG;: Trace flow flags are set as follows: 


Drange euaidels Schedule failed 

A eee Storage shortage 

» «XX XXXX Space reserved for module flow indicator 

00 TRXNORM — Normal cleanup 

01 TRXNTERM NOTERM entered 

02 TRXLTERM Logical unit in termination — 

03 TRXWORK — VSCS ignoring work to process request 

04 TRXNWORK_ No work to process DTIVLOFF called 

05 TRXCONN Logical unit in termination state with CCS con- 

nection 

06 TRXACTIV — Logical unit state is not termination with no con- 
, 7 nection 

07 TRXIGNOR CCS has been notified or DTIPRBRK has set a 


timer to force purge. VSCS is waiting. | 
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VSCS Data Trace Record Formats 


Input Trace Entry 


00 

04 

08 

OC WEBCOUNT 

10 WEBDATA 
Displacement: 
00 Character “Il” for Input 
01 WEB function code 


02 WEB mode 
00 Console (No MORE/HOLDING) 
01 CMS 
02 Full-screen 
04 Internal 
03 Zero 
04-07 DTITAB address 
08-—OB DTIWEB address 
O0C-OD WEBCOUNT 
OE-xx WEBDATA (18 bytes for internal or 221 bytes for external) 


Output Trace Entry 


04 DTITAB address 

: 
: 

10 WEBDATA 


Displacement: 


00 Character “O” for Output 
01 WEB function code 
02 WEB mode 
00 Console (No MORE/HOLDING) 
01 CMS 
02 Full-screen 
04 Internal 
03 Zero 
04-07 DTITAB address 
08-—OB DTIWEB address 
O0C-—OD WEBCOUNT 
OE-xx WEBDATA (18 bytes for internal or 221 bytes for external) 
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VSCS Dispatcher Trace Record Formats 


When the dispatcher trace option is active, VSCS traces all traffic through the 
VSCS state managers. This trace can be limited to one or several logical units by 
starting the VSCS dispatcher trace for selected logical units. Use the VSCS 
TRACEON (DISP command to start the VSCS dispatcher trace. See “VSCS 
Tracing Commands’ in VTAM Operation for additional information on the VSCS dis- 
patcher trace. The dispatcher trace produces two types of record formats: 


e Logical-unit-related for traffic associated with logical units 
e Global for traffic not associated with a logical unit. 


The following examples show the format of records created for each event. | 


Dispatcher Trace Entry for a Logical Unit: Entry 1 


00 
04 
08 
ac 
10 
14 
18 
1C 


Displacement: 


00 Header ID 
D No module ID found or address of module is zero 
P Presentation services dispatcher 
V VTAM services dispatcher 
01 LBCSTTUS and current task running 
Paweu Gaview LBCSIP 1=busy, O=not busy 
XK Kinin Zero 
a ie Unknown task running 
ads Presentation services task running 
Gia tes 11 | VTAM services task running 
02-03 Zero 
04-07 DTITAB Address of TAB passed 
08-OB DTIWEB Address of current WEB 
OC WEBFUN WEB function code from input WEB 
OD WEBMODE WEB mode from input WEB 
00 Console (No MORE/HOLDING) 
01 CMS 
02 Full-screen 
04 Internal 
OE WEBVSRPS_ VTAM services response to SEND request from pres- 
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VSCS Dispatcher Trace 


01 WEBVSOPC Operation check 
02 WEBVSLFU Unconditional LOGOFF 
03 WEBVSERR_ Unrecoverable 1!/O error 
04 WEBVSBSY Printer busy 
05 WEBVSIRQ _Intervention required 
06 WEBVSNAV Printer not available 
07 WEBTWXER TWX READ error, sense code 0827 
08 WEBVSAOK Successful completion 
OC WEBVSVER_ Unrecoverable internal error 
OD WEBVSPSL Presentation space integrity lost 
OE WEBVSCNL SEND canceled by cancel key 
OF WEBVSCC1_ Reflect attention, CC1 on SIO 
10 WEBVSECU Equipment check and unit specify 
11 WEBVSDCU Data check and unit specify 
12 WEBVSEC = _ Equipment check 
13 WEBVSCRJ Command reject 
14 WEBVSDC Data check 
15 WEBVSCC Command check 
OF Zero 
10 LBCSTATE from PLB 
Lice Sarde LBCINT Internal mode if on (on=1). 
i eee LBCFSSMF  Full-screen support mode flags 
= LBCFSAV Screen available 
siesidvs LBCFSII Full-screen input inhibited: 
B'00' CP (Console) mode 
B'01' Virtual machine mode state 
between ATTN and READ, 
queue CP messages 
B'10' Virtual machine mode queue CP 
messages 
B'11' Virtual machine mode available 
for switch 
oe LBCCOPY Copy mode: on=1 
Jags LBCNAL NAL flag: on=1 
ae ae LBCHOLD HOLDING flag: on=B'11' 
i ai LBCM10 MORE 10 flag: on=1 
Bare LBCM50 MORE 50 flag: on=1 
poise eae 1 LBCCMSD _ Screen written with a CMS DIAGNOSE: 
on=1 
dsieeey ausiere No MORE/HOLDING state (all bits off) 
11 PLBFSSMF  Full-screen support mode flags 
Litea: aes PLBFPAT1 PA1 key received switch mode 
splieke— sp caus PLBFSRFC Mode switch required (FSSM to Console) 
mcd ceaeiert PLBFSAFC Switch available (FSSM to Console) 
tls shies PLBFCNMP Console message pending 
a ee PLBFVSIP —§ VTAM services SEND in progress 
pa nee PLBFCLGF Conditional LOGOFF received 


weaks PLBFCMRR CP message pending, response required 
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13 


14 
15 


16-17 
16 


17 
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PLBPRLBC 
PLBOFLG1 


PLBNOM 
PLBNFLG1 


eXXX XXXX 
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PLBCMSEW Screen has just been erased 
VTAM services LOGOFF flags for presentation services 


PLBLVS 
PLBLGFC 
PLBLGFU 


PLBLERR 
PLBLLERR 


PLBLVERR 


PLBLSEVR 
PLBLNSTR 
PLB flags 
PLBLGO 
PLBINAR 
PLBLFLNP 
PLBCONCT 
PLBCNCT| 
PLBINREC 
PLBPRMPT 
PLBSDIAL 


VTAM services LOGOFF received, 
bypass logo 

WEBINLGEF sent to CCS conditional 
LOGOFF 

WEBINLGEF sent to CCS unconditional 
LOGOFF 

WEBINERR sent to CCS for hard error 
WEBINLER sent to CCS for interface 
error 

WEBINVER sent to CCS for internal 
logic error 

CP CCS SEVER received, must SEVER 
No storage indicator in LOGOFF 


Logo mode logical unit 

APL/TEXT starting in input area 
LOGON from logo not permitted 
Current count incremented 

IUCV CONNECT issued 

Input received during purge processing 
Usability prompt message flag 
SNA-dialed logical unit 


Previous logical unit LBCSTATE 
Output manager flags 


PLBSDIAG 
PLBPSMSG 
PLBOSRIP 
PLBOKLOK 
PLBOKPMI 
PLBOSWRT 
PLBOCRRQ 


PLBOEXRQ 


CMS DIAGNOSE on screen 

Priority message on screen 

SEND retry in progress 

Keyboard locked 

Keyboard printer mask input area sent 
CMS WRITE active (no input received) 
Carriage return required before SEND on 
hard-copy terminal 

‘’ required before SEND on hard-copy 
terminal | 


Notify output manager 


NOM flag 1 
PLBCEND 
PLBRDTX 
PLBSAC 
PLBCLROA 
PLBCLRIA 
PLBRING 


PLBUNLK 
NOM flag 2 
PLBRDPND 


Command end (READ) 
Redisplay timer has expired 
Status area change required 
Clear output area 

Clear input area 

Ring the alarm 

Zero 

Unlock keyboard 


Redisplay pending 
Zero 
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18 PLBEDIT Editing flags 
PLBNCONV 


flict. hanes PLBPPWRT 


oe leer PLBHIEKO 

alive PLBEDPT| 

ae PLBNOEKO 
PLBEDCUP 
19 PLBIAFLG 
PLBMATTN 
ree PLBSATTN 
ara Ede conan PLBIPA1 

a eee PLBBRKNN 


deers PLBUNSRD 
weed: KN 
1A 
PLBDASS 
colieie. seenays PLBDNEW 
Mek a. eas PLBNOVCK 


PLBDCH 


awek aera PLBDXTDS 
& Nes PLBDXCLR 
edie PLBDXHLI 
ele PLBDATTN 
PLBDMASK 


1B Zero 


VSCS Dispatcher Trace 


User-translated output data 

Password prompt message 

Zero 

Highlight input redisplay 

Do not print or do not display 

Do not redisplay input on next output line 
Convert to upper case 


Input manager attention handling flags 


Multiple attention received 

Single attention received 

Attention received in MORE 

CP TERMINAL BRKKEY - NONE in 
effect 

Unsolicited READ received 

Zero 


Device manager flags 


Display has alternate size 

Bit is on for a 3278, bit is off for a 3277 
Do not validity check data 

Display has new color or highlight func- 
tions, no B'000' 

Extended data stream available 
Extended color available 

Extended highlight available 

Printer attention 

Password mask 


1C-1F Last four characters of module ID 


Dispatcher Trace Entry for a Logical Unit: Entry 2 


o fe [ww 


LU path ID 


04 LBCSTATE VLBFLG VLBFLG1 VLBFLG2 
08 VLBSENDF VLBERFLG VLBLRCD VLBERCVY 


OC VTAM 


Displacement: 


00 Header ID 'Z' 
01 Zero 
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VSCS Dispatcher Trace 


02-03 


04 


05 


06 


07 


08 


09 


0A 
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Logical unit path ID 


» XXXX 
VLBFLG1 


eeee «XXX 


LBCSTATE VLB 


LBCVSST 


VLB flags 
VLBBSPBB 
VLBBSPEB 
VLBBSINB 
VLBSR 


VLB flag 1 
VLBIOTR 
VLBCLSD 
VLBPCS 
VLBSIGNL 
VLBCHGD 
VLBRETR 
VLBRETS 
VLBSNDRD 
VLB flag 2 
VLBRPLB 
VLBCLPND 


VLBBUSY 
VLBNAV 
VLBOPCK 
VLBWAIT 
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VTAM services state: O=Normal, 
1=Termination 


Bracket-state pending begin bracket 
Bracket-state pending end bracket 
Bracket-state in bracket | 
Application SEND or RECEIVE state: 
1=SEND state, O=RECEIVE state 
Zero 


Inbound data received since last SEND 
CLSDST not required 

Purging chain state 

SIGNAL sent 

Change Direction required 

Retry RECEIVE request 

Retry SEND request 

Active SEND is a Read (ER mode only) 


RPL in use 

VTAM CLSDST pending 
Zero 

Printer busy 

Printer not available 
Operation check occurred 
Waiting for data or LUSTAT 


Special SEND indicator 


VLBCLR 
VLBSDT 
VLBCANC 
VLBSIGRQ 
VLBCHECK 


CLEAR required 

START DATA TRAFFIC (SDT) required 
CANCEL required | 

SIGNAL required 

Bypass CHECK macro 

Zero 


VLBERFLG — Exception response flags 


VLBPSHLD 
VLBERPND 
VLBERRIP 
VLBERPRG 
VLBPRGDN 
VLBERPRM 
VLBEREXT 
VLBRCVNO 


DTIXMT pending (PS held) 

Error recovery pending 

Error recovery in progress 

Permanent error: purge logical unit 
Purge complete 

Permanent error 

Exit received control before return 

Do not reissue RECEIVE SPECIFIC for 
logical unit 


LOGOFF reason codes 


VLBVTLO 


VTAM LOGOFF 
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i eee VLBVRYI VARY INACTIVE 
atl ieee VLBHLTQ HALT QUICK 
soll haee VLBHLTC HALT CANCEL 
ram lorry VLBIOE Unrecoverable I/O error 
elias VLBINERR __ Internal error 
nawe. ws XX Zero 
OB VLBERCVY 
dh “eras VLBERCLR CLEAR requested 
wleate: Granag VLBERBRK __ Bracket error occurred 
iole. <Gue VLBERSDT START DATA TRAFFIC required 
Reme lparerers VLBERSIG SIGNAL required 
ae Pee VLBERCNL CANCEL received 


vale VLBERCDR_ Change Direction required 
iota: acts VLBERPSL Presentation space integrity lost 
sunaaas deeahe 1 VLBERHRD ~ Hard error occurred 
OC-OF VTAM CID (OAF/DAF) 
10-1F Zero 


Dispatcher Trace Entry for a Global Connection 


: 
: 
¢ 
: 
: 
: 
: 
: 

Displacement: 

0 Trace record header ID 
D No module ID found or module address is zero 
P Presentation services dispatcher 
V VTAM services dispatcher 
1 LBCSTTUS and current task running 
eal leer Address of SAB included 
MX: Kaige Zero 
als Presentation services task running 
sales ai 11 VTAM services task running 
eed ee Unknown task running 
02-03 SABIQECB First two bytes of SABIQECB event control block (ECB) 
04-07 Address passed 
08—O0B Address of WEB 


oC SABFLG1 
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OD 


OE 


OF 


11 


12 


13 


» XX XXXX 
SABTFLG1 


« XXXX 


» XXXX 
WEBFUN 


WEBMODE 


WEBCHAR 


WEBEDIT 


SABDBCSC 


SABVSCSV 
SABDUIP 


SABCSOPN 
SABBUFDQ 


SABGETFL 


SABNEWLG 


SABVEIBS 


“Restricted Materials of IBM” 
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VSCS and CCS are DBCS capable 
VSCS running in VTAM machine 
Dump in progress 

VSIUCV open 

DTISGETB dequeue type: FIFO=1, 
LIFO=0 — 

GETMAIN failed 

New logo format allowed 

VEIB shortage has occurred 


Abend-in-progress flags 


SABPABIP 
SABUABIP 


Presentation services abend in progress 
Utility services abend in progress 
Zero 


Global termination flags 


SABTETPE 
SABTESIQ 
SABTETIP 

SABTEATP 


TPEND in progress 

Termination scheduled by DTIIQUIT 
Termination in progress 

Abnormal termination in progress 
Zero 


Global recovery flags 


SABVSCTL 
SABPSCTL 
SABTICTL 

SABCXCTL 


VTAM services task in control 
Presentation services task in control 
Timer exit in control | 
Communications services exit in control 
Zero 


WEB function code. This is explained in “WEB Func- 
tion Codes” on page 535. 


Mode: 


00 Console 


01 CMS 


02 Full-screen 


04 Internal 


Character set (set by CCS for Console and CMS 


modes) 


0O EBCDIC character set 

01 APL character set 

02 TEXT character set 

04 DBCS character set 

05 DBCS and APL character set 
06 DBCS and TEXT character set 
Editing characteristics 


WEBIMMED 
WEBPETCM 


WEBCLRSC 


WEBHIEKO 
WEBEDPTI 


Mode switch immediately 
‘PRESS ENTER TO CONTINUE’ 
message 

CP clear screen 

Zero 

Highlight input display 

Do not print or do not display 
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14 


15 


16-17 

16 
17 

18-19 


1A 
1B 


1C-1F 


WEBLINE 
WEBLAID 
WEBNLLOS 
WEBCURSR 


WEBTABCH 
WEBRSVSA 


WEBNOEKO 
WEBEDCUP 


WEBRSV1 


VSCS Dispatcher Trace 


Do not redisplay input on next output line 
Convert to uppercase 


Zero 


WEBCONMD Request for display in CONMODE 3270 


WEBLED 
WEBANFSW 


WEBDIAL 


Limited edit diagnose 

Allow any full-screen WRITE; first full- 
screen WRITE after reset. 

SNA-dialed logical unit 


WEBNOMOR CMS ERASE or WRITE no "MORE" 


WEBPRMPT 
WEBPASPA 


requested 
WEBDATA contains pre-logon message 
Pass PA1 (FSSM) as data to application 


CCS status flags for VSCS 


WEBCPNCR 


WEBCPPRI 
WEBCPALM 
WEBSAHLD 
WEBCPMDE 
WEBSAMOR 
WEBCPHLW 
WEBCPRSP 
WEBSARSP 
WEBCPRRR 
WEBSARRR 
WEBCPRNR 
WEBSARNR 


Do not imbed carriage return in data 
stream (on hard-copy terminal) 
Priority flag 

Ring the alarm 

HOLDING 

CP-generated bit = 1 

MORE VM-generated bit = 0 
Highlight WRITE requested 
Indicates CCS response 

Indicates VSCS response 

CCS request, requires response 
VSCS request, requires response 
CCS request, requires no response 
VSCS request, requires no response 


Line number for CMS WEBCMWRT 

Logical attention identifier 

Number of lines left on screen 

Cursor position may be a relative address or a buffer 


address 


Tab (not DTITAB) character 
Reserved for VSCS use 


WEBCPRDS 
WEBNOVCK 
WEBATTNW 
WEBINLIP 


WEBCHDIR 


DTIWEB is a redisplay DTIWEB 

Do not validity check data 

Attention WRITE (VSCS only) yes = 1 
Logon in progress 

Zero 

Change Direction required 


WEBMASKW WRITE inhibit mask 


Zero 


Last four characters of module ID (or entry address) 
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VSCS Operator Trace Record Formats 


MSGS Trace Entry (MSGS) 

The MSGS trace entry provides an indication in the VSCS trace table (or externally) 
when a message occurs. A single record will contain the message number and 
any variable text. This information can provide a good starting place in the VSCS 
trace for a problem that occurs after or just before a VSCS operator message is 
issued. 


This trace will be active when the VSCS trace option OPER is activated or the ALL 
trace option is used to start the trace. 


The content of each record would be as follows: 


: 
04 

Time Stamp 
08 | 
: 
f 
: 
: 
Displacement: 


00-03 Characters “MSGS” 

04-0B Timestamp when message was issued 
OC-OF Message ID DTIxxxx 

10-13 Caller return address 

14-17 Message variable 1 

18-1B Message variable 2 

1C-—1F Message variable 3 


Following is an example of formatted records: ~ 


MSGS TIMESTAMP A5F726FF 841B4101 MSGI $15I CALLER 402B344C 
VARIABLES 002B3980 FAB3A9C8 D4D7D3C5 
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OPER Trace Entry (OPER) 

The OPER trace entry provides an indication in the VSCS trace table (or externally) 
when a VSCS operator command is issued. As much of the command text as will 
fit into one record will be recorded. This information can provide a good starting 
place in the VSCS trace for a problem that occurs after or just before a VSCS oper- 
ator command is issued. 


This trace is active when the VSCS trace option OPER is activated or the ALL . 
trace option is used. 


The content of each record would be as follows: 


00 


04 


Time Stamp 


08 
ec 
10 
14 Command Data 
18 
1C 


Displacement: 


00-03 Characters “OPER” 
04-0B Time stamp when message was issued 
O0C—1F Command data 


Formatted records look like: 


OPER TIMESTAMP A5F726FF 84093501 CMD DATA S 
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VSCS Storage Statistics Trace Record Format 


STAT Trace Entry (STAT) — | 

The STAT trace entry records storage statistics when the storage manager CHECK 
function is processed. This trace provides a method for monitoring VSCS storage 
utilization over a period of time. The information can be used to determine the 
correct storage size of the VSCS virtual machine and determine the storage costs 
of various VSCS initialization parameters and start options. 


This trace is active when the VSCS trace option STAT is activated. 
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The content of each record would be as follows: 


00 S A 


I 
STATLVL STATVTMM | STATSSO STATVES 
STATONL STATFSR STATXTDS 


| 


04 


08 


0c STATDPAC 

0 STATATAR 

«same [so 
: 
Se 
a 
es ce 
es 
es 
: 
: 
rs 
: 
ce 
es 
ee ce 
es 
es 
ce 
es 
Ss 
es coe 
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es Cc 
of sme 
2 
2 Cc 
Ss 
2 
2 Ce 
a 
ce 
es 
oS 
a 
Se Cc 
: 
2 
es 
2 
ee 
Coe 
ce 
Ss 
Se 
ce 
2 
Coe 
Se 


Displacement: 


00-03 Characters “STAT” 


04 STATLVL VSCS level 

05 STATVTMM VSCS in VTAM machine 
06 STATSSO Storage shortage occurred 
07 STATVES VEIB shortage 

08 STATONL ONE LOGO value 

09 STATFSR FS READ BUFFER value 


OA-OB STATXTDS DPXMTL value 
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OE-OF 
10 

11 
12-14 
15-16 
17 

18 

19 
1A-1B 
1E-1F 
22-23 
26-27 
2A-2B 
2E-2F 
30-33 
34 

35 
36-39 
3A-3B 
3C-3D 
3E-3F 
42-43 
46-47 
4A-4B 
4E-4F 
52-53 
56-57 
5A-5B 


5E-5F 


62-63 
66-67 
6A-6B 
6E-6F 
72-73 
76-77 
7A-7B 
7E-7F. 
82-83 
86-87 
8A-8B 
8E-—8F 
92-93 
96-97 
9A-9B 
9E—9F 
A2-A3 
A6-—A7 
AA-AB 


STATDPAC 
STATDEX 
STATAQLM 
STATXTKP 
STATKPAC 
STATKEX 
STATRECS 
STATER 
STATCHKT 
STATRELT 
STATVTMS 
STATCPS 
STATMCPS 
STATVSAM 
STATVEIB 
STATBLKM 
STATRPLS 
STATRECL 
STATTSKR 
STATTABR 
STATGET 
STATGETS 
STATSSZ 
STATGETF 
STATSWAP 
STATFREM 
STATFRES 
STATBDC 
STATBDS 
STATHW(1) 
STATVS(1) 
STATAL(1) 
STATAV(1) 
STATTL(1) 
STATHW(2) 
STATVS(2) 
STATAL(2) 
STATAV(2) 
STATTL(2) 
STATHW(3) 
STATVS(3) 
STATAL(3) 
STATAV(3) 
STATTL(3) 


VSCS Storage Statistics Trace 


DPACE value 

DEXIT value 

AQLIMIT value in K (1024 bytes) 
KPXMTL value 

KPACE value 

KEXTI value 

RECEIVE SPECIFIC value 
Exception response active 
Storage check time 

Storage release time 

Number of VTAM sessions 
Number of CP connections 
Maximum CP connections 
VSAMLM value 

Number of VEIBs 

BLKMULT value 

Number of RPLs 

RECBFL value 

TASK retry value 

LU retry value 

Number of GETMAIN's issued 
Number of special GETMAINs 
Size of special GETMAINs 
Number of GETMAIN failures 
Number of SWAP's done 
Number of FREEMAIN's issued 
Number of special FREEMAINs 
Count of bad segments 

Size of bad segments 
Highwater mark 

VTAM sessions . 
Allocated segments 

Available segments 

Total storage in bytes 
Highwater mark 

VTAM sessions 

Allocated segments 

Available segments 

Total storage in bytes 
Highwater mark 

VTAM sessions 

Allocated segments 

Available segments 

Total storage in bytes 


STATHWM(1) Highwater mark 
STATVTM(1) VTAM sessions 
STATSEG(1) Number of segments 
STATTSG(1) Total storage in bytes 
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VSCS Storage Trace 


AE-AF STATHWM(2) Highwater mark 
B2-B3 STATVTM(2) VTAM sessions 
B6-B7 STATSEG(2) Number of segments 
BA-BB STATTSG(2) Total storage in bytes 
BE-BF STATHWM(3) Highwater mark 
C2-C3 STATVTM(3) VTAM sessions 
C6-C7 STATSEG(3) Number of segments 
CA-CB STATTSG(3) Total storage in bytes 
Formatted records look like: 

STAT VSCSLVL 07 VTAM N SHORTAGE N VSHORT N ONELOGO N FSREAD Y 
DPXMTL @000079C DPACE 0000 DEXIT N AQLIMIT 10 KPXMTL @0011C0@ KPACE  00A 
KEXIT . SPEC N SCHED N STCHKTM @0@Q000A STRELTM 00000000 
VTAMSES 0000001 CPCON 00000001 MAXCPCON 00000001 VSAMLM 000A VEIBS  Q0Q00Q0F 
BLKMULT 01 RPLNUM 10 RCVBFRL 00000059 TSKRTRY OQOA LURTRY 0005 
GETMAIN 00000019 SGETMN 00000000 SGETSIZE 00000000 GETFAILS 90000000 SWAPS 09000002 
FREEMAIN 00000003 SFREEMN 60000000 BADCOUNT @0000000 BADSIZE 00000000 
HW/MARK QQ0@000A VTAMSES 60000001 ALLOCATE @Q0QQ000A AVAILABL 00000007 TOTAL  000C000 
HW/MARK 00000002 VTAMSES 00000001 ALLOCATE 00000002 AVAILABL 00000001 TOTAL 00002000 
HW/MARK QQ0Q000A VTAMSES 00000001 ALLOCATE 00000008 AVAILABL 00000004 TOTAL 0000B000 
HW/MARK 00000002 VTAMSES 00000001 AVAILABL 0000000 TOTAL 00000000 
HW/MARK ©0@00000 VTAMSES 90000000 AVAILABL 00000000 TOTAL 00000000 
HW/MARK 00000000 VTAMSES 00000000 AVAILABL 0000000 TOTAL 00000000 


VSCS Storage Trace Record Formats 


FREB Trace Entry | 
B 


00 F R E 
: 
: 
10 POOLID 
: 
: 
1C Zero | 
Displacement: 
00-03 Characters “FREB” 
04-07 DTIPDB address 
08-—OB Block being freed 
OC-OD SMP header 
OE-OF Block ID (DTIEHDR identifier) 
10 Storage pool number 
1 Presentation services 
2  VTAM services 
3 VTAM Exit Services 
11-13 Zero 
14—17 First caller's return address 
18-1B Caller's caller's (Second caller's) return address 
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1C-—1F Zero 


GETB Trace Entry 


00 
04 
08 
OC 
10 
14 
18 
1C 


a 


Displacement: 


00-03 
04-07 
08-OB 
OC-0E 
OF-11 
12 


13 
14-17 
18-1B 
1C-1E 


1F 


Characters “GETB” 

DTIPDB address 

Block address obtained 

Size requested 

Size to be cleared 

Storage pool number 

1 Presentation services 

2  VTAM services 

3  VTAM Exit Services 
Module return code 

First caller's return address 
Caller's caller's (second caller's) return address 
State 

ENA Caller running enabled 
DIS Caller running disabled 


PDB flags 
ee Storage shortage 
.1.. .... Used next PDB 
..l. .... Forced to use static storage 
..1 .... | Checked all PDBs, no storage available 
. 1... | Bad PDB count 
.1.. PDB lock not available 


sea ace. feces xx Zero 


VSCS VTAM Exit Trace Record Formats 


lf you are running the default VSCS trace and you have activated the trace with an 
operator command, or by starting VSCS with the VTAM exit trace active, VSCS 
traces all inbound traffic through the VSCS VTAM exits. You can limit the VTAM 
exit trace to a selected set of logical units by starting the VSCS VTAM exit trace for 
those logical units. 


You can produce the VTAM exit trace in two formats: 


e Normal trace record if the request is a valid VSCS logical unit 
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e Data trace record if the request or response was not valid, or if the data traced 
is different from the normal VTAM exit trace record. 


Below is the format for the records created for each event. 


VSCS VTAM Exit Trace: Entry 1 


o fw) mem 
. 
. 
: 
: 
: 
: 
¢ 

Created by: 

e DTIVCLSX 
e DTIVDFAX 
e DTIVLOGX 
e DTIVNSEX 
e DTIVOPNX 
¢ DTIVRECX 
e DTIVRESX 
e DTIVRLQX 
e DTIVSCIX 
e DTIVSNDX 


508 = VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


VSCS VTAM Exit Trace 


Displacement: 
00 V=VTAM services 
01-03 Three-character module ID DTIVxxxxX 
04-07 TAB address for current request 
08—-OB RPL address 
oC RPL request code 
OD Module return code 
OE-OF Source network address 
10-11 RPLFDBK2 
12-13 RPLUSNSI (user sense) or RPLSSNSI (system sense) 
14 LBCSTATE from VLB 
bee: qa 1 LBCVSST VTAM services state: 
O=Normal 
1=Termination 
15 VLBERFLG — Exception response flags 
eer ee VLBPSHLD DTIXMT pending (PS held) 
a ee VLBERPND Error recovery pending 
ses ee VLBERRIP _ Error recovery in progress | 
ie Lt ees VLBERPRG Permanent error: purge logical unit 
is sdleiats VLBPRGDN Purge complete 
hee VLBERPRM Permanent error 
dade VLBERSND_ Exception Response SEND issued 
ees es 1 VLBRCVNO_ Do not reissue RECEIVE SPECIFIC for 
logical unit 
16-17 LU path ID 
18-1B VLBSWAP 
18 VLBFLG VLB flags 
Lita ees VLBBSPBB _ Bracket state-pending begin bracket 
sae VLBBSPEB _ Bracket state-pending end bracket 
a ee VLBBSINB _ Bracket state-in bracket 
el x VLBSR Application SEND or RECEIVE state: 
1=SEND state, O=RECEIVE state 
ie KKK Zero 
19 VLBFLG1 VLB flag 1 
Lie wees VLBIOTR Inbound data received since last SEND 
indicator 
ee VLBCLSD CLSDST: O=required, 1=not required 
et ree VLBPCS Purging chain state 
re reer VLBSIGNL SIGNAL sent 
Sicletes VLBCHGD Change Direction required 
ak VLBRETR Retry RECEIVE request 
ela VLBRETS Retry SEND request 
Sees deceit 1 VLBSNDRD Active SEND is a Read (ER mode only) 
1A VLBFLG2 VLB flag 2 
Toten meets VLBRPLB RPL in use 
oo eee VLBCLPND VTAM CLSDST pending 
XX Gs Zero 
ee VLBBUSY Printer busy 
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1B VLBSENDF 


Passe a XXX 
1C VLBLRCD 
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VLBNAV Printer not available 

VLBOPCK Operation check occurred 

VLBWAIT Waiting for data or LUSTAT 

Special function flags 

VLBCLR CLEAR required 

VLBSDT SDT required 

VLBCANC CANCEL required 

VLBSIGRQ — SIGNAL required 

VLBCHECK Bypass CHECK macro 
Zero 

LOGOFF reason codes 

VLBVTLO VTAM LOGOFF 

VLBVRYI VARY INACTIVE 

VLBHLTQ HALT QUICK 

VLBHLTC HALT CANCEL 

VLBIOE Unrecoverable I/O error 

VLBINERR __ Internal error 


zero 


1D-—-1F VTAM Module-dependent data 


VTAM Exit Module-Dependent Data 


The module flow indicator values in byte 03 are in hexadecimal. 


DTIVCLSX: 


01-03 WEB address or zero 


DTIVDFAX: 
01 WEBFUN value 
02 Reserved 
03 Module flow indicator 


°o eXX XXXX 
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DTIVPURG called 
Space reserved for module flow indicator 
02 SEND issued unsupported command 


03 DTIWBLD issued 
04 DTISCHED issued 
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DTIVLOGX: 


01 WEBFUN value 
02 SABTFLG1 field 
03 Module flow indicator 
Lea ean Asynchronous CLSDST issued 
i Peer eeee Synchronous CLSDST issued 
Seale wavered Purge called for recovering LU CLSDST not done 
» oXX XXXX Space reserved for module flow indicator 


01 Start NIB build process 

03 Started building session parameters 

05 DTIVTRMI called 

06 Attempting OPNDST 

07 Device or BIND format is not valid 

08 Unsupported auxiliary device or unsupported 
screen size 


DTIVNSEX: 


01-03 Bytes 0-2 of input data field 


DTIVOPNX: 
01 WEBFUN value 
02 Zero 
03 Module flow indicator 
Lear voters CHECK failed 
« »XX XXXX Module flow indicator 
01 DTIWBLD issued 
02 DTISKED issued 
04 Cleanup request ignored 
08 DTIWBLD for RECEIVE SPECIFIC failed 
10 Cleanup called for LU 
DTIVRECX: 
01 WEBFUN value 
02 Return code from CHECK macro 
03 Module flow indicator 
fi are eae Reserved 
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« XX XXXX Space reserved for module flow indicator 


01 
02 
03 


512 VTAM V4R2 Diagnosis 


Major (non-recoverable) error detected 
Asynchronous device end received 

Failure sending exception response (to exception 
request) | 

SEND failure trying to issue a normal response 
DTIVRECM failure 

DTINQ failure 

DTIWBLD failure 

DTIDQ failure 

Chaining accumulator error 

Error attempting to send chain format error 
response 

Error attempting to send RU length error response 
In purging chain state 
First in chain received 

Middle of chain received 

End of chain received 

VTAM chain indicator error 

LUSTAT=No input mechanism 

TWX read error 

Null RU with Change Direction processed 

Entry is not valid — TAB is not valid or CID mis- 
match 

Entry ignored — logical unit undergoing CLSDST 
DTIVLOFF called for logical unit 

Null RU without Change Direction processed 
LUSTAT=Device available 

LUSTAT=Printer not available 
LUSTAT=Component failure 
LUSTAT=Presentation space lost 

I/O error occurred 

Normal SEND response received 

Request ignored; RPL is busy 

DTIVRECM called 
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DTIVRESX: 


01 


02 


03 


WEBVSRPS 
X'15' 
X'14! 
X'13! 
X'12' 
X'11' 
X'10' 
X'0F' 
X'0E' 
X'0D' 
X'0C' 
X'08' 
X'07' 
X'06' - 
X'05' 
X'04!' 
X'03' 
X'02! 
X'01' 
VLBERCVY 


WEBVSCC 
WEBVSDC 
WEBVSCRJ 
WEBVSEC 
WEBVSDCU 
WEBVSECU 
WEBVSCC1 
WEBVSCNL 
WEBVSPSL 
WEBVSVER 
WEBVSAOK 
WEBTWXER 
WEBVSNAV 
WEBVSIRQ 
WEBVSBSY 
WEBVSERR 
WEBVSLFU 
WEBVSOPC 


VLBERCLR 
VLBERBRK 
VLBERSDT 
VLBERSIG 

VLBERCNL 
VLBERCDR 
VLBERPSL 
VLBERHRD 


Module flow indicator 
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Reserved 


VSCS VTAM Exit Trace 


Command check 

Data check 

Command reject 
Equipment check 

Data check and unit specify 


Equipment check and unit specify 


Reflect attention, CC1 on SIO 
SEND canceled - CANCEL key 
Presentation space integrity lost 
Unrecoverable internal error 
Successful completion 

TWX read error sense X'0827' 
Printer not available 
Intervention required 

Printer busy 

Unrecoverable I/O error 
Unconditional LOGOFF 
Operation check 


CLEAR requested 

Bracket error occurred 

START DATA TRAFFIC required 
SIGNAL required 

CANCEL received 

Change Direction required 
Presentation space integrity lost 
Hard error occurred 
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0 eXX XXXX 


Request code 
UNBIND type 


WEBVSRPS 


DTIVRLQX: 
01-03 Zero 
DTIVSCIX: 
01 
02 
03 Zero 
DTIVSNDX: 
01 
X'15' 
X'14' 
X'13' 
X'12' 
X11! 
X'10' 
X'OF' 
X'OE' 
X'OD' 
X'0C' 
X'08' 
X'07' 
X'06' 
X'05' 
X'04' 


514 VTAM V4R2 Diagnosis 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Module flow indicator 


01 
02 


WEBVSCC 
WEBVSDC 
WEBVSCRJ 
WEBVSEC 


Purge logical unit 
SEND requested 


_ Error recovery pending 


Error recovery in progress, request ignored 
Error element not found 

Unrecoverable error occurred 

Dequeue failure 

Logical unit being purged 

CLEAR canceled request 

Failure not found during recovery 

Recovery pending or in progress and LU is busy 
Recovery pending or in progress and LU is not 
busy 

No recovery setup and device is busy 

Entry is not valid — TAB is not valid or CID mis- 
match — 


Entry ignored — logical unit undergoing CLSDST 


DTIVLOFF called 
Full-screen error 
Cancel key 0811 


Command check 
Data check 

Command reject 
Equipment check 


WEBVSDCU Data check and unit specify 
WEBVSECU Equipment check and unit specify 


WEBVSCC1 


Reflect attention, CC1 on SIO 


WEBVSCNL SEND canceled - CANCEL key 


WEBVSPSL 


Presentation space integrity lost 


WEBVSVER_  Unrecoverable internal error 
WEBVSAOK Successful completion 
WEBTWXER_ TWX read error sense X'0827' 
WEBVSNAV Printer not available 


WEBVSIRQ 
WEBVSBSY 


Intervention required 
Printer busy 
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02 


03 


X'03' 
X'02! 
X'01' 
VLBERCVY 


WEBVSERR 
WEBVSLFU 
WEBVSOPC 


VLBERCLR 
VLBERBRK 
VLBERSDT 
VLBERSIG 

VLBERCNL 
VLBERCDR 
VLBERPSL 
VLBERHRD 


Module flow indicator 
DTIVPURG called 

DTIVLOFF called 

Entry ignored — logical unit undergoing CLSDST 
Entry is not valid — TAB is not valid or CID mismatch 
Sense OCOD occurred during Exception Response 
LUDOWN routine called 


VSCS VTAM Exit Trace: Entry 2 


Created by: 


DTIVCLSX 
DTIVDFAX 
DTIVLOGX 
DTIVNSEX 
DTIVOPNX 
DTIVRECX 
DTIVRESX 
DTIVRLQX 
DTIVSCIX 

DTIVSNDX 


SEQUENCE #1 


Displacement: 


00 


es 


X=VTAM services 
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Unrecoverable I/O error 
Unconditional LOGOFF 
Operation check 


CLEAR requested 

Bracket error occurred 

START DATA TRAFFIC required 
SIGNAL required 

CANCEL received 

Change Direction required 
Presentation space integrity lost 
Hard error occurred 


915 


VSCS VTAM Exit Trace 


| “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


01-03 Three-character module ID DTIVxxxX 


04 LBCSTATE from PLB 
Lots aia LBCINT 
Pe Ge ee LBCFSSMF 
a eee LBCFSAV 
ae LBCFSIl 


Internal mode --> 1 

Full screen support mode flags 
Screen available 

Full-screen input inhibited: 


B'00' CP (Console) MODE 

B'01' Virtual machine mode state 
between ATTN and READ, 
queue CP messages 


-~B'10' Virtual machine mode queue CP 


messages 
B'11' Virtual machine mode available 
for switch. 
nied nes LBCCOPY Copy mode: on=1 
ene pare LBCNAL NAL flag: on=1 
sae th ble LBCHOLD HOLDING flag: on=B'11' 
sed bie LBCM10 MORE 10 flag: on=1 
eee LBCM50 MORE 50 flag: on=1 
eas teh 1 LBCCMSD _ Screen written with a CMS DIAGNOSE: 
ON=1 
sisters protec No MORE/HOLDING state (all bits off) 
05 PLBFSSMF  Full-screen support mode flags 
Tes aes: PLBFPA1 PA1 key received switch mode 
lies. ake PLBFSRFC Mode switch required (FSSM to Console) 
Seda araeis PLBFSAFC = Switch available (FSSM to Console) 
gers Bodies PLBFCNMP Console message pending 
2 Leak PLBFVSIP = VTAM services SEND in progress 
as eles PLBFCLGF Conditional LOGOFF received 
Pee PLBFCMRR CP message pending, response required 
Sasck, Seine l PLBCMSEW Screen just cleared 
06 PLBLFLG1 VTAM services LOGOFF flags for presentation services 
rere PLBLVS VTAM services LOGOFF received 
A ee a das PLBLGFC WEBINLGF sent to for CCS conditional 
LOGOFF | 
i ere ee PLBLGFU WEBINLGF sent to for CCS uncondi- 
tional LOGOFF 
Gl Ges PLBLERR WEBINERR sent to CCS for hard error 
ae eer PLBLLERR  WEBINLER sent to CCS for interface 
error : 
eee PLBLVERR WEBINVER sent to CCS for internal 


..1. PLBLSEVR 


ree 1 PLBLNSTR 
07 PLBFLG1 flags 

| ree PLBLGO 

Lave. Sieve PLBINAR 
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logic error 

CP CCS SEVER received, VSCS must 
SEVER 

No storage indicator in LOGOFF 


Logo mode logical unit 
APL or TEXT starting in input area 
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puedes 1 
08 PLBPRLBC 
09 PLBOFLG1 
Lissa Was 
his 
se Mae. Ss 
nol tes 
ab Lees 
ees 
mae 


0A-0B PLBNOM 


OA PLBNFLG1 
Legs asin 
a ee 
es 
sale wan 
pales 
a ee 
oX. 
aan Oe 1 
0B PLBNFLG2 
Teac AunGe 
. oXXX XXXX 
oc PLBEDIT 
I asc athe 
sill se 
XX ces 
sless 
iss 
ls 
bate et 1 
oD PLBIAFLG 
ee 
Fee 
elie 
as a 
. Wee 
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PLBLFLNP 


PLBCONCT 
PLBCNCTI 
PLBINREC 
PLBPRMPT 
PLBSDIAL 


VSCS VTAM Exit Trace 


LOGON from logo not permitted for this 
LU 

Current count incremented 

IUCV CONNECT issued 

Input received during purge processing 
Usability prompt message flag 

SNA dialed logical unit 


Previous logical unit LBCSTATE 
Output manager flags 


PLBSDIAG 
PLBPSMSG 
PLBOSRIP 
PLBOKLOK 
PLBOKPMI 
PLBOSWRT 
PLBOCRRQ 


PLBOEXRQ 


CMS DIAGNOSE on screen 

Priority message on screen 

SEND retry in progress 

Keyboard locked 

Keyboard printer mask input area sent 
CMS WRITE active (no input received) 
Carriage return required before SEND 
(on hard-copy terminal) 

“!’ required before SEND (on hard-copy 
terminal) 


Notify output manager 


NOM flag 1 
PLBCEND 
PLBRDTX 
PLBSAC 
PLBCLROA 
PLBCLRIA 
PLBRING 


PLBUNLK 
NOM flag 2 
PLBRDPND 


Editing flags 
PLBNCONV 
PLBPPWRT 


PLBHIEKO 
PLBEDPTI 
PLBNOEKO 
PLBEDCUP 


Command end (READ) 
Redisplay timer has expired 
Status area change required 
CLEAR output area 

CLEAR input area 

Ring the alarm 

Zero 

Unlock keyboard 


Redisplay pending 
Zero 


User translated output data 

Password prompt message 

Zero 

Highlight input redisplay 

Input printing or non-display 

Do not display input on next output line 
Convert to upper case 


Input manager attention handling flags 


PLBMATTN 
PLBSATTN 
PLBIPA1 

PLBBRKNN 


PLBUNSRD 


Multiple attention received 

Single attention received 

Attention received in more 

CP TERMINAL BRKKEY - NONE in 
effect 

Unsolicited read received 
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OE 


OF-1F 
OF-1F 
OF-11 
12-1B 
12-13 
14-17 
18-1B 
1C-1D 


1E-1F 
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.1.... PLBIPA1M Multiple attentions received for a TWX 
LU and a Read is not Active or 
Response pending 
er PLBATIN | Signal Request-to-Send received 
waeeet: Secs 1 PLBAWLOS PRESS ENTER TO CONTINUE 
| message is on the screen 
PLBDFLG1 Device manager flags 


Lessee: ciaians _  PLBDASS Display has alternate size 
a aiak digs PLBDNEW __ Display has new APL or TEXT 
mole. waar PLBNOVCK Do not validity check 
ne Up ge PLBDCH Display has new color or highlight func- 
tions 
No = no color or highlight functions 
a) ee PLBDXTDS Extended data stream available 
oe rere PLBDXCLR- Extended color available 
me Wee PLBDXHL1 Extended highlight available 


Saas evel PLBDATTN Printer attention 

‘cated aes 1 PLBDMASK Password mask 

Zero 

Reserved except for VDFA, VREC and VSND 

RPLCNTL Control information from current RPL 

Reserved for VDFA 

DATALEN Length of data sent or received 

WEBADDR__—Work element address 

WEBDATA _ First four bytes of data sent or received 

Sequence number 1, only used by VRES, VSND and VREC. For 
VRES and VREC, sequence number 1 contains RPLSEQNO. For 
VSND, sequence number 1 contains RPLSEQNO if the SEND was 
non-LMPEO (RPLLMPEO was off). If the SEND was LMPEO, then 
sequence number 1 is the first sequence number in the chain of PIUS 
(RPLOBSQV). | 
Sequence number 2, only used by VSND. It contains the sequence 
number of the last PIU in the chain of PlUs if the SEND was LMPEO 
(RPLLMPEO is on). For non-LMPEO SEND its contents are the same 
as sequence number 1. 
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VTAM Exit Data Trace Entries 
DTIVCLSX: 


: 
: 
: 
: 
: 
? 
: 
: 

Displacement: 

00-03 Characters “VCLS” 

04 RPL request code 

05-07 Zero 


0O8—OB TAB address is not valid 
OC-OF RPLCID 

10-13 Input RPL address 
14-17 DTIWEB address 


18-1B Zero 

1C X'FF' to indicate data entry 

1D-1F Zero 

DTIVDFAX: 

: 
, 
: 
: 
: 
: 
: 
: 
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Displacement: 


00-03 Characters “VDFA” 
04-07 Input ACB address 
08-OB Input CID 
OC-—OF Input TAB address 
10-13 Zero 
14-17 Input RPL address 
18-1B DTIWEB address 
1C X'FF' to indicate data trace entry 
1D WEBFUN value 
1E Zero 
1F Module flow indicator 
. weetr ears DTIVPURG called 
“xx xxxx Module flow indicator 
01 SEND issued supported command 
02 SEND issued unsupported command 
03 DTIWBLD issued 
04 DTISCHED issued 
DTIVLOGX: 
: 
o 
: 
ac 
: 
14 
LU name 
18 | 
i 


Displacement: 


00-03 
04—07 
08—0B 
OC-—OF 
10-13 
14-1B 
1C 

1D 


1E 
1F 
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Characters “VLOG” 

Input ACB address 

Address of logical unit name 

Zero 

Length of logon message 

Logical unit name 

X'FF' to indicate data trace entry 
WEBFUN value. This is explained in “WEB Function Codes” on 
page 535. 

SABTFLG1 field 

See “DTIVLOGX’” for settings for 1F. 
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DTIVLOSX: 
a 
; 
: 
: 
: 
: 
: 


Displacement: 


00-03 Characters “VLOS” 
04-07 Input ACB address 
08-0B Input CID 
OC-OF Input NIB user field 
10-13 Reason code (The reason codes are right-justified in the four-byte field.) 
OC Contact lost 
14 Unconditional LOGOFF 
20 Conditional LOGOFF 
24 Buffer limit 
14-17 TAB address or zeros 
18-1B WEB address or zeros © 
1C X'FF' to indicate data trace entry 


1D-1E Zero 
1F Module flow indicator 
ees DTIVPURG called 
.»XX xxxx Module flow indicator 
1 DTIWBLD issued 
2 DTISKED issued 
DTIVNSEX: 
: 


: 
: 
: 
: 
‘ 
: 
: 
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Displacement: 


00-03 Characters “VNSE” 

04-07 Input ACB address 

08-—OB Input CID 

OC-—OF Input TAB address 

10-13 RPL address 

14-17 RPL address 

18 RPL request code 

19-1B Zero 

1C X'FF' to indicate data trace entry 

1D-1F First three bytes of input data field 

DTIVOPNX: 
: 
: 
: 
: 
10 
14 Zero 
18 
: 


Displacement: 


00-03 
04 
05-07 
08-0B 
OC-OF 
10-1B 
1C 
1D 
1E 
1F 
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Characters “VOPN” 

RPL request code 

Zero 

TAB address is not valid 
RPL address 


Zero 

X'FF' to indicate data trace entry 
WEBFUN 

Zero 

Module flow indicator 

ree CHECK failed 

. XX xxxx Module flow indicator 


01 DTIWBLD issued 

02 DTISKED issued 

04 Cleanup request ignored 

08 DTIWBLD for RECEIVE SPECIFIC failed 
10 Cleanup called for LU 
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DTIVTPNX: 
© 
: 
: 
: 
: 
; 
: 
: 


Displacement: 


00-03 Characters “VTPN” 

04-07 ACB address 

08—OB TAB address 

OC-—OF Number of current VTAM sessions 

10-13 Number of current CP connections 

14-17 Maximum number of CP connections up to this point 
18-1B SABFLGS1 field 


18 SABFLG1 First set of DTISAB flags 
Teiog ai ene SABDBCSC VSCS and CCS are DBCS capable 
eMeener Bares Zero 


ae eae ee SABDUIP Dump in progress 
ee eee ee SABCSOPN IUCVINI SET done 
« dees SABBUFDQ Dequeue type: FIFO=1 LIFO=0 
ee SABGETFL GETMAIN failed 
prekis SABNEWLG New logo format allowed 


ine: sok 1 SABVEIBS _ VEIB shortage has occurred 
19 SABABIPF ABEND in progress flags 
Mice ty Sena thee SABPABIP Presentation services abend in progress 
liesiay~ oreie SABUABIP _ Utility services abend in progress 
» oXX XXXX Zero 
1A = SABTFLG1_ Global termination flags 
de deeds SABTETPE TPEND in progress 


Pe ear ee SABTESIQ Termination scheduled by IQUIT 
na ee SABTETIP Termination in progress 
ee eee SAPTEATP Abnormal termination in progress 
» XXXX Zero 


1B SABRFLG1 = Global recovery flags 
Loke sae SABVSCTL VTAM services in control 
Si ere SABPSCTL Presentation services in control 
ese - Sass SABTICTL — Timer services exit in control 


see Ls gett, SABCXCTL Communication services exit in control 
iets ees SABVXCTL VTAM Services exit in control 
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be bis cK Zero 
1C X'FF' to indicate data trace entry 
1D-1F Zero 

DTIVRECX: 
: 
: 
: 
: 
: 
: 
: 

Displacement: 

00-03 Characters “VREC” 

04 RPL request code 

05-07 Zero 

08—OB TAB address is not valid 

OC-—OF VLB address 

10-13 Input WEB address 

14—-17 RPL address 

18-1B Zero 

1C X'FF' to indicate data trace entry 

1D WEBFUN 

1E Check return code 

1F Module flow indicator 
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XKiet eta Zero 
..XX XXxx Module flow indicator 
01 Major (non-recoverable) error detected 
02 Asynchronous device end received 
03 Failure sending exception response (to exception 
request) 
04 SEND failure trying to issue a normal response 
05 DTIVRECM failure 
06 DTINQ failure 
07 DTIWBLD failure 
08 DTIDQ failure 
09 Chaining accumulator error 
OA Error attempting to send chain format error response 
OB Error attempting to send RU length error response 
OC In purging chain state 
OD First in chain received 
OE Middle of chain received 
OF End of chain received 
10 VTAM chain indicator error 
11 LUSTAT=No input mechanism 
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12 TWX read error 

13 Null RU with Change Direction processed 

14 Entry is not valid — TAB is not valid or CID mismatch 
15 Entry ignored — logical unit undergoing CLSDST 
16 DTIVLOFF called for logical unit 

17 Null RU without Change Direction processed 

18 LUSTAT=Device available 

19 LUSTAT=Printer not available 

1A Component failure 

1B Presentation space lost 

1C I/O error occurred 

1D Normal SEND response received 


DTIVRESX: 


00 


: 
08 
S 
i 
: 
i 
: 

Displacement: 

00-03 Characters “VRES” 

04 RPL request code 

05-07 Zero 

O8—OB~ TAB address is not valid 

OC—OF VLB address 

10-13 Input WEB address 

14—17 RPL address 

18-1B Zero 

1C X'FF' to indicate data trace entry 

1D WEBFUN 

1E Check return code 

1F Module flow indicator 


XXia ¢e3 Zero 
~»Xx xxxx Module flow indicator 
01 Purge logical unit 
02 SEND requested 
03 Error recovery pending 
04 Error recovery in progress, request ignored 
05 Error element not found 
O6 Unrecoverable error occurred 
07 Dequeue failure 
08 Logical unit being purged 
09 CLEAR canceled request 
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OA Failure not found during recovery 

OB Recovery pending or in progress and LU is busy 

OC Recovery pending or in progress and LU is not busy 
OD No recovery setup and device is busy 

14 Entry is not valid — TAB is not valid or CID mismatch 
15 Entry ignored — logical unit undergoing CLSDST 

16 DTIVLOFF called 

17 Full-screen error 

18 Cancel key 0811 


DTIVRLQX: 
00 
04 
ACB name 
08 
0c 
LU name 
10 
14 ; DTITAB address 
: 
: 


Displacement: 


00-03 Characters “VRLQ’ 

04-0B ACB name 

0C-13 Logical unit name 

14-17 TAB address 

18-1B Zero 

1C X'FF' to indicate data trace entry 
1D Return code passed to VTAM 


1E-1F Zero 

DTIVSNDX: 

: 
. 
: 
: 
: 
: 
: 
: 
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Displacement: 


00-03 
04 
05-07 
08-0B 
0C-OF 
10-13 
14-17 
18-1B 
1C 
1D 
1E 
1F 


Characters “VSND” 
RPL request code 
Zero 
TAB address is not valid 
VTAM services local block (VLB) address 
Input WEB address 
RPL address 
Zero 
X'FF' to indicate data trace entry 
WEBFUN 
Check return code 
Module flow indicator 
XK Zero 
XX XXXX Module flow indicator 
01 Major (non-recoverable) error detected 
02 Asynchronous device end received 
03 Failure sending exception response (to exception 
request) 
04 SEND failure trying to issue a normal response 
05 DTIVRECM failure 
06 DTINQ failure 
07 DTIWBLD failure 
08 DTIDQ failure 
09 Chaining accumulator error 
OA Error attempting to send chain format error response 
OB Error attempting to send RU length error response 
OC In purging chain state 
OD First in chain received 
OE Middle in chain received 
OF Last in chain received 
10 VTAM chain indicator error 
11 LUSTAT = no input mechanism 
12 TWX read error 
13 Null RU with CD 
14 Entry is not valid — TAB is not valid or CID mismatch 
15 Entry ignored — logical unit undergoing CLSDST 
16 DTIVLOFF called 
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DTIVSCIX: 
; 
: 
: 


Displacement: 


00-03 Characters “VSCI” 
04-07 ACB address 
08—OB CID (not used) 
_ OC-OF TAB address 
10-13 RPL address 
14-17 RPL address 
18 RPL request 
19-1B Zero 
1C X'FF' to indicate data trace entry 
1D Request code , 
1E UNBIND type 
1F Zero 


DTIVSEND: Entry 1 


S 
: 
. 
: 
: 
: 
: 
1c Zero 

Displacement: 


00-03 Characters “VSEN” 

04-07 DTITAB address a 

08-OB DTIWEB address (DTICMT, DTIWEB, DTIXMT) 

oc XMTFLG1 
i re XMTCD Change Direction required (for start/stop) 
SS ee XMTRSHOW Redisplay in DTIXMT buffer 
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pile. ceed XMTPMSG _ Priority message on screen 
eek: wees XMTDIAG CMS DIAGNOSE on screen 
a aes XMTLRU Logo RU 
Pare er XMTATTN — Attention write (VSCS only) yes = 1 
pieces le XMTINPT Input expected from logical unit 
ine eee 1 XMTPWMSK Password mask 
OD XMTFLG2 
Lydd arte XMTVSRBL DTIVDATR called 
Gh wa aioe XMTERCMT  DTIXMT is really a DTICMT 
oles aaias XMTERERR Error retry necessary 
Sok Gee XMTERPSL _ Presentation space lost error 
re re XMTLMPEO LMPEO SEND initiated 
psig. a Zero 
ete Wine 1 XMTKEYRS_ Contains data that will reset the key- 
board (LUO and LU2) 
OE MODE or TYPE of request 
B Busy 
C Control command 
D Definite response 
E Exception response 
| Send request ignored. 
P Logical unit purged 
R Send request delayed. 
X Recovery request 
W Logical unit waiting 
OF XMTSTATE — LBCSTATE of PLB saved in XMT 
cee. galers LBCINT Internal mode if on (on=1) 
hie See LBCFSSMF  Full-screen support mode flags 
bei: Suis LBCFSAV Screen available 
ele: aoa LBCFSII Full-screen input inhibited: 
B'00' CP (Console) mode 
B'01' Virtual machine mode state 
between ATTN and READ, 
queue CP messages 
B'10' Virtual machine mode queue 
CP messages 
B'11' Virtual machine mode available 
for switch. 
or eee LBCCOPY Copy mode: on=1 
weee 1... LBCNAL NAL flag: on=1 
eee. cok LBCHOLD HOLDING flag: on=B'11' 
aay oe LBCM10 MORE 10 flag: on=1 
seca Jocbelis LBCM50 MORE 50 flag: on=1 
i ader wace 1 LBCCMSD _ Screen written with a CMS DIAGNOSE: 
on=1 
asiteis. ashios No MORE/HOLDING state 
10 LBCSTATE from PLB 
Lida, Siete LBCINT Internal mode if on (on=1). 
UA Moe ste LBCFSSMF  Full-screen support mode flags 
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acleere LBCFSAV Screen available 
seals LBCFSII Full-screen input inhibited: 
B'00' CP (Console) mode 
B'01' Virtual machine mode state 
between ATTN and READ, 
queue CP messages 
B'10' Virtual machine mode queue 
CP messages 
B'11' Virtual machine mode available 
for switch. 
sig l 195i LBCCOPY Copy mode: on=1 
ie eee LBCNAL NAL flag: on=1 
res oie LBCHOLD HOLDING flag: on=B'11' 
ies LBCM10 MORE 10 flag: on=1 
wails LBCM50 MORE 50 flag: on=1 
sedan: ese 1 LBCCMSD _— Screen written with a CMS DIAGNOSE: 
on=1 
Suet eieein No MORE/HOLDING state 
11 PLBFSSMF — Full-screen support mode flags 
Wg oe. ceria PLBFPA1 PA1 key received switch mode 
od es PLBFSRFC Mode switch required (FSSM to Console) 
Jade % PLBFSAFC = Switch available (FSSM to Console) 
oe ieee PLBFCNMP Console message pending 
a eee PLBFVSIP — VTAM services SEND in progress 
Side PLBFCLGF Conditional LOGOFF received 
woke PLBFCMRR'_ CP message pending, response required 
ieee, sees 1 PLBCMSEW Screen has just been erased 
12 PLBLFLG1 — VTAM services LOGOFF flags for presentation services 
Daecw: caiiers PLBLVS VTAM services LOGOFF received 
ghee PLBLGFC WEBINLGF sent to CCS for conditional 
LOGOFF 
are PLBLGFU WEBINLGF sent to CCS for uncondi- 
tional LOGOFF 
or ee PLBLERR WEBINERR sent to CCS for hard error 
ae ne PLBLLERR WEBINLER sent to CCS for interface 
error 
eA PLBLVERR WEBINVER sent to CCS for internal 
logic error 
ee PLBLSEVR CP CCS SEVER received, VSCS must 
SEVER 
et a 1 PLBLNSTR __ No storage indicator in LOGOFF 
13 PLBFLG1 PLB flags 
Le Shy eed PLBLGO Logo mode logical unit 
re lan PLBINAR APL or TEXT starting in input area 
jade PLBLFLNP ~=LOGON from logo not permitted for this 
LU 
ee ae PLBCONCT Current count incremented 
aca PLBCNCTI IUCV CONNECT issued 
PS ye PLBINREC __ Input received during purge processing 
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14 
15 


16 


17 


sec PLBPRMPT 
PLBSDIAL 


VSCS VTAM Exit Trace 


Usability prompt message flag 
SNA dialed logical unit 


PLBPRLBC Previous LBCSTATE from PLB 


PLBNFLG1 — NOM flag 1 
PLBCEND 
.l...... PLBRDTX 
1. ....  PLBSAC 

..1.... PLBCLROA 
. 1... PLBCLRIA 
1... PLBRING 


PLBUNLK 


Command end (READ) 
Redisplay timer has expired 
Status area change required 
CLEAR output area 

CLEAR input area 

Ring the alarm 

Zero 

Unlock keyboard 


PLBOFLG1 — Output manager flags 


PLBSDIAG 
plow: aes PLBPSMSG 

Ae eer ene PLBOSRIP 
a ee PLBOKLOK 

e Asses PLBOKPMI 
aleve PLBOSWRT 
Aral PLBOCRRQ 


PLBOEXRQ 


PLBFSCLR 
dil ois ates PLBFSRBI 
wp dey. “Senes PLBPASPA 
oe eee PLBWSFRO 
a dines PLBCONMD 
Pe eee PLBFSRBS 


ed's PLBBEEP 
PLBFSPND 


18-—1B  Caller's return address 


1C 


1D-1F 


zero 
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CMS DIAGNOSE on screen 

Priority message on screen 

SEND retry in progress 

Keyboard locked 

Keyboard printer mask input area sent 
CMS WRITE active (no input received) 
Carriage return required before SEND on 
hard-copy terminal 

“” required before SEND on hard-copy 
terminal 


CMS CLEAR while in FSSM state 
Full-screen read buffer issued 

Pass PA1 as data (FSSM) 

WSF query issued 

CONMODE 3270 request 

Full-screen read buffer SEND in 
progress 

Full-screen break-in beep in progress 
Full-screen request could not be proc- 
essed and is on the pending queue 


X'FEF' to indicate data trace entry 
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DTIVSEND: Entry 2 


: 
. 
: 
: 
: 
14 WEB/CMT ADDRESS 

18 BYTES 1 - 4 OF DATA 

: 


00-03 Characters 'VSE1' 
04-07 VTAM CID (OAF/DAF) 
08-OB VLBSWAP — VTAM services flags — 


08 VLBFLG — VLB flag 

Deity, dates VLBBSPBB _ Bracket-state pending begin bracket 

gL Bed. iationaks VLBBSPEB _ Bracket-state pending end bracket 

a eae VLBBSINB _ Bracket-state in bracket 

ee eee VLBSR Application SEND or RECEIVE state: 
1=SEND state, O=RECEIVE state 
» XXXX Zero 

09 VLBFLG1 — VLB flag 1 

L igax Bea VLBIOTR Inbound data received since last SEND 


ee ease VLBCLSD CLSDST not required 
ee eee VLBPCS Purging chain state 
Sal eres VLBSIGNL SIGNAL sent 
gf dees VLBCHGD Change Direction required 
Y alec VLBRETR Retry RECEIVE request 
sieeve, ceeds VLBRETS Retry SEND request 
date. eee 1 VLBSNDRD _ Active SEND is a Read (ER mode only) 
OA VLBFLG2 — VLB flag 2 


Disnie. eerie VLBRPLB RPL in use 
lates wees VLBCLPND VTAM CLSDST pending 
ao > ene Zero 


wie aes VLBBUSY Printer busy 
a re VLBNAV Printer not available 
Sake VLBOPCK Operation check occurred 


ipa 1 VLBWAIT Waiting for data or LUSTAT 
OB VLBSENDF — Special function flags 

Dae ee VLBCLR CLEAR required 
slits: Coats VLBSDT START DATA TRAFFIC (SDT) required 
cee eer VLBCANC CANCEL required 

a eee VLBSIGRQ _— SIGNAL required 

ie ees VLBCHECK Bypass CHECK macro 

ee We OO Zero | 
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0C 


VLBVTLO 
.l.. ....  VLBVRYI 
..1.....  VLBHLTQ 
..1.... VLBHLTC 
. 1... VLBIOE 
.l..  VLBINERR 
ea ay ee 
OD 
VLBPSHLD 
.l......  VLBERPND 
..l. ....  VLBERRIP 
..1....  VLBERPRG 
. 1... VLBPRGDN 
..1.. VLBERPRM 
..1. | VLBERSND 
VLBRCVNO 
OE VLBFLG3 
VLBNULLS 
.l.. ....  VLBSCIPR 
..l. .... VLBCLRCV 
..1....  VLBSCSIM 


sees VLBINOFC 
.l.. - VLBERRCV 


‘ile VLBERCLQ 
VLBERSCH 


OF 
VLBERCLR 
dlicwkar. <euiasane VLBERBRK 
soi. rere VLBERSDT 
ale sieaatecd VLBERSIG 
j: Deas VLBERCNL 
agate VLBERCDR 
re VLBERPSL 
VLBERHRD 
10 
C=CLEAR N=None 
S = SDT 
Z = SIGNAL 
11 Zero 
12-13 Data count sent 
14-17 WEB/CMT address 
18-1B ‘First 4 bytes of data sent 
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VLBLRCD — LOGOFF reason codes 


VTAM LOGOFF 

VARY INACTIVE 

HALT QUICK 

HALT CANCEL 
Unrecoverable |/O error 
Internal error 

Zero 


VLBERFLG — Exception response flags 


DTIXMT pending (PS held) 

Error recovery pending 

Error recovery in progress 

Permanent error: purge logical unit 
Purge complete 

Permanent error 

Exception Response SEND issued 

Do not reissue RECEIVE SPECIFIC for 
logical unit 


Null SEND executed 

SCIP exit retry in progress 

Last input received was a CLEAR key 
SCIP exit retry in progress SIMLOGON 
required 

Operator FORCE command issued for 
this LU 

Reissue RECEIVE SPECIFIC in 
response mode 

Clean queue when SEND completed 
Schedule response when SEND com- 
pletes 


CLEAR needed 

Bracket error 

SDT needed 

SIGNAL needed 
CANCEL received 
Change Direction needed 
Presentation space lost 
Hard error occurred 


Command code when TRDMODE is a C = control command sent 
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X'FF' to indicate data trace entry 
1D-1F Zero 


DTIVSIML 


00 
04 
08 
ac 
10 
14 
18 
: 
Displacement: 
00-03 Characters “VSIM” 
04—07 Input RPL address 
08-OB RPLFDBWD 
OC-OF RPLFDBK2 
10-17 Logical unit name 
18-1B DTITAB address 
1C X'FF' to indicate data trace entry 
1D-1F Return code from CHECK macro 
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DTITAB address 
Exit data 
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LBCSTATE Values for PLBINxxx 


Console Mode 


Name 
PLBINNMH 
PLBINM50 
PLBINM10 
PLBINHLD 
PLBINNAL 
PLBINCPY 


Hex Value 
00 

02-03 
04-05 
06-07 
08-—OF 
10-1F 


CMS Edit Mode 


Name 
PLBINCMS 
PLBINM50 
PLBINM10 
PLBINHLD 
PLBINNAL 


Hex Value 
01 

02-03 
04-05 
06-07 
08—OF 


WEB Function Codes 


Description 

No MORE or HOLDING condition 
MORE condition, 50 second timer set 
MORE condition, 10 second timer set 
HOLDING 

Not accepted logic condition 

PF key Copy in progress 


Description 

No MORE or HOLDING condition 
MORE condition, 50 second timer set 
MORE condition, 10 second timer set 
HOLDING 

Not accepted logic condition 


Full-Screen Support Mode (FSSM) 


Name 
PLBINFSS 


Hex Value 
20, 40, 60 


Internal Modes 


Name 
PLBINLIP 
PLBINLUP 
PLBINCIP 
PLBINIIP 
PLBINAWL 
PLBINLGF 
PLBINCLF 
PLBINSVR 
PLBINPRG 


WEB Function Codes 


Hex Value © 


80 
81 
82 
83 
84 
85 
86 
87 
88 


Description 
Full-screen support mode 


Description 

LOGON in progress 
Logo up 

Connect in progress 
Inlog in progress 
Attention wait before logo 
LOGOFF 

Conditional LOGOFF 
SEVER required 

Purge in progress 


The tables in this section show the bits defined in field WEBFUN, the function code 
for VSCS. The function code depends on the value in WEBMODE: 


e If WEBMODE is 04, use “Function Codes for Internal States” on page 536. 
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Internal function codes represent work functions within VSCS. These are not 
considered to be inbound or outbound. | 


e For all other WEBMODEs: 


— For inbound, use “Function Codes for Inbound Processing in All Modes” on 
page 537. Inbound function codes represent work elements that are 
received by CCS. 


— For outbound, use the WEBMODE: 


- If the WEBMODE is 00, use “Function Codes for Outbound Processing 
in Console Mode” on page 537. 


- If the WEBMODE is 01, use “Function Codes for Outbound Processing 
in CMS Mode” on page 538. 


- If the WEBMODE is 02, use “Function Codes for Outbound Processing 
in Full-Screen Mode” on page 538. 


Outbound function codes represent work functions sent from CCS to VSCS, 
or generated internally in VSCS. The mode of the request (CMS, console, 
or FSSM) determines which function is performed. 


Note: in this book, whenever a flow is referred to as inbound or outbound, use 
console communication services (CCS) as the reference point. That is, flows 
toward CCS are inbound; flows away from the CCS are outbound. 


Function Codes for Internal States 


Name Hex Value Description 
WEBNTM10 00 Timer expired - MORE 10 second, 
source = System Services 
WEBNVLFC 01 LOGOFF conditional, source = VTAM Services 
WEBNVLFU 02 LOGOFF unconditional, source = VTAM services 
WEBINERR- 03 Unrecoverable I/O error, LOGOFF condition 
WEBINPUT 04 Attention identifier and optional data input 
WEBNVFLW 05 LOGOFF warning, source = VTAM services 
WEBNSRSP 06 Input/output response (could be either normal or 
error), source = VTAM services | 
WEBNVLGO 07 LOGON response, source = VTAM services 
WEBNACON 08 Accept connect, source = CCS 
WEBNSEVR 09 Sever connection, source = CCS 
WEBNMSGC 0A IUCV one-way message complete, source = CCS 
WEBNTM50 OB Timer expired - MORE 50 second, 
source = System Services 
WEBNTNAL OD Timer expired - not accepted 3 second 
WEBNTF60_ OE Timer expired = FSSM 60 second, 
| source = System Services 
WEBVSBRK OF _ LOGOFF request, source = presentation services 
WEBNVASY_ 10 _ Asynchronous error - WEBVSRPS indicates type 
WEBPSSRU_ 10 SEND request, source = presentation services 
WEBNVCLU 11 Internal VTAM request cleanup, source = VTAM 
services 
WEBNSIML 12 Request to VTAM services to issue SIMLOGON 
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WEBNTCPY 13 PF key Copy wait for printer SIMLOGON timer 
expired 

WEBNTPRT 14 Timer expired for request to release printer after 
RELREQ exit driven 


WEBINOFC 14 Operator issued VSCS FORCE command — proc- 
essing continues in DTIPFORC 


Function Codes for Inbound Processing in All Modes 


Name Hex Value Description 

WEBINLOG 01 LOGON request 

WEBINATT 02 Attention interrupt without data 

WEBINERR- 03 Unrecoverable I/O error, LOGOFF condition 

WEBINPUT 04 Attention identifier with optional data 

WEBINCB1 05 Move cursor back one 

WEBINLGF 06 VTAM-generated LOGOFF condition, CCS logs 
user off 

WEBINFNU_ 07 FSSM request rejected, screen not in user mode 

WEBINAOK 08 Normal response 

WEBINACT 09 Accounting data for CCS 

WEBINOPC OA Operation check for FSSM request 

WEBINLER OB Logical interface error (DTIWEB) 

WEBINVER OC _ VSCS internal processing error 

WEBRDERR OD Error in input data found by the NCP 

WEBINVTM OE Identify VTAM user ID to CCS 


Function Codes for Outbound Processing in Console Mode 


Name Hex Value Description | 

WEBCPWRT 00 WRITE to next available line in output area 

WEBCPRED 01 READ request 

WEBCPBRK 02 Break connection (CP LOGOFF or DISCON- 
NECT) 

WEBCPWIC 03 WRITE to input area and then position cursor as 
indicated in WEBCURSR 

WEBCPCPY 04 COPY request 

WEBCPIED 05 Environment definition is not valid 

WEBCPFKR 06 PFK REPLY - treat as terminal input 

WEBCPIDA 07 Data accepted, proceed with input processing 

WEBCPINA 08 Input not accepted 

WEBCPREX 09 IREPLY expected by way of synchronous 

WEBCPTAB OA PF key TAB operation 

WEBCPLER OB Logical interface error (WEB) (ISEND or REPLY) 

WEBCPLOG OC Logo 

WEBCPTMR OD Command end (no output for command entered) 

WEBCPPTH OE IUCV path ID 

WEBCPCAH OF Color and highlight map 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Chapter 11. Using VSCS Service Aids (VM) 537 


WEB Function Codes “Restricted Materials of IBM” 
| Licensed Materials — Property of IBM 


WEBCPLSA_ 10 Device information (terminal command) 


Function Codes for Outbound Processing in CMS Mode 


Name Hex Value Description | 

WEBCMWRT 00 WRITE to line number specified in WEBLINE 

WEBCMEWT 01 ERASE output area and WRITE to line number 
specified in WEBLINE 

WEBCMCLR 02 ERASE entire screen and refresh the format of 


the output, input, and status areas 


Function Codes for Outbound Processing in Full-Screen Mode 


Name Hex Value Description 
WEBFSWRT 00 FSSM WRITE 
WEBFSEWT 01 FSSM ERASE/WRITE 
WEBFSEWA 02 FSSM ERASE/WRITE ALTERNATE 
WEBFSRDM 03 FSSM READ MODIFIED — 
WEBFSRDB 04 FSSM READ BUFFER 
WEBFSWSF 05 FSSM WRITE STRUCTURED FIELD 
WEBFSEAU 06 FSSM ERASE ALL UNPROTECTED 
WEBFSRBP 07 FSSM READ BUFFER by position 
WEBFSRMP 08 FSSM READ MODIFIED by position 
WEBINCC1 OF FSSM reflect attention, CC1 on SIO 
WEBINECU 10 FSSM equipment check and unit specify 
WEBINDCU 11 FSSM data check and unit Specify 
WEBINEC 12 FSSM equipment check 
WEBINCRJ 13 FSSM command reject 
WEBINDC 14 FSSM data check 

-WEBINCC 15 FSSM control check 
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Chapter 12. Using Other Problem Solving Tools 


Many different service aids are available to help you collect information about SNA 
network problems. This chapter describes when to use the following aids: 


e “Alert Messages from NCP” 

e “Recording NMVT Alerts in LOGREC” 

e “Messages Issued for 3745 Bus Switching” on page 549 

e “Hardware Error Recording” on page 549 

e “Logical Unit Connection Test (IBMTEST)” on page 550 

e “NCP Error Recording” on page 551 

e “Patch Areas” on page 551 

e “Using Save Area Module Linkage Conventions—Subarea’” on page 552 


e “Using Save Area Module Linkage Conventions—APPN” on page 555. 


Alert Messages from NCP 


The NCP in a 3720, 3725, or 3745 communication controller sends alert messages 
to the VTAM program whenever a serious or permanent error occurs in the commu- 
nication controller. 


The NCP sends hardware error records to the maintenance operator subsystem 
(MOSS). If the MOSS determines that they are permanent errors, it sends them 
back to the NCP, which forwards them to all owning host processors. 


If a communication network management (CNM) application program, such as the 
NetView program, is active and authorized to receive alert messages, VTAM for- 
wards the alert messages to that program. Otherwise, VTAM sends a message to 
the operator's console. 


Recording NMVT Alerts in LOGREC 


A network management vector transport (NMVT) is a SNA request unit (RU) that 
contains solicited or unsolicited data, such as line statistics and generic alerts. 
LOGREC and SYSREC are host data sets that contain records of 
various types of system failures, both hardware and software. 


VTAM records all unsolicited NMVT alerts from 3745s and all NMVT alerts from 
local area networks and ES/9370" processors in either LOGREC or SYSREC. If 
you have the NetView program, VTAM also forwards the NMVT alerts to the 
NetView hardware monitor for recording. The NetView program interprets the error 
information for its operator panels. To determine what book contains more informa- 
tion on NetView's presentation of generic alerts, see Table 80 on page 1165. For 
more information on generic alerts generated by First Failure Support Technology 
(FFST), see “First Failure Support Technology (FFST) for VTAM (MVS) (VM)” on 
page 217. 


VTAM identifies and records an NMVT alert as follows: 


e Each NMVT has an SNA network services (NS) header of X'41038D'. 
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e Each NMVT that is an alert has a management services (MS) major vector of 
X'0000'. | 

e To determine the type of device that sent the NMVT alert, VTAM checks the 
product ID subvector (X'11') of the NMVT for the hardware machine type. 
Each type of device has its own unique machine type; for example, each NMVT 
alert that comes from a 3745 has a machine type of C'3745'. 


e VTAM records the NMVT alert in LOGREC or SYSREC as a miscellaneous 
data record (MDR: type=X'91') with a device type of NMVT (X'30'). 


You can format and print NMVT alerts from LOGREC or SYSREC using the 
_ Environmental Record Editing and Printing program (EREP). 


e At offset X'1A' of the MDR record is the 8-byte resource name of the sender 
of the MNVT alert. 


e At offset X'24' of the MDR record is the NMVT data. The first five bytes of the 
data are not included. See Table 80 on page 1165 to determine what book 
contains information on how to use EREP. 


Alerts (VM) (VSE) 

VTAM uses the alert function to notify an operator of an actual or impending loss of 
availability of a resource. VTAM builds a network management vector transport 
(NMVT) for the alert. The NMVT can be traced with the PIU option of the VIT. The 
PIU trace of the NMVT contains several extensions. Figure 78 is an example PIU 
trace entry of an alert NMVT. 


D7C9E440 43990000 00863DD8 40000000 *PIU .cceeee Q ...* 
20000000 00000001 00000001 1C000001 rere eee eee * 
D7CIE4F2 00000001 00860B00 0041038D SPIO wise areas weate * 
00001000 10007B00 O00A0401 80000000 Keccses Fivkg be kw * 
D7C9E4F2 O1000COA 01081057 O61A0COF *PIUSS seveweeeees * 
153C1000 2311040E O2F5F6F6 F4F2F8FO Weccsecees 5664280* 
D7C9E4F2 FOFIF3F1 F10804FQ F3FOF1FO *PIUZ201311. .03010* 
FIOA06C1 C3C661E5 E3C1D416 11011300 *1,.ACF/VTAM..... * 
D7C9E4F2 11F9F3F7 F5000000 OQ00FOFO *PIU2.9375..... Q0* 
FOFOFOF5 F60E5104 02000508 03400000 *00056........ * 
D7C9E4F2 00003105 52030404 0D910001 WPIUZ. cecersecene * 
OFOO8000 C100C100 0004A108 4603A105 Wo wiea Nolesieaeste es 


Figure 78. PIU Trace Entry Example (NMVT RU) 


The NMVT RU that is traced contains the alert (X'0000') management services 
major vector. See Table 80 on page 1165 to determine what books describe the 


alert major vector and its subvectors. 


In the preceding example, the alert major vector has three subvectors that identify 
alert-description-code information. The first subvector, hex 91, is a basic alert sub- 
vector that has an alert description code of C1. Two hex A1 values identify the 
detail-qualifier subvectors for alert C1. (Depending on the type of alert, up to three 
detail-qualifier subvectors follow the basic alert subvector; see “LAN Alert 
Description Codes (VM) (VSE)” on page 541 for details.) The detail-qualifier sub- 
vectors have values of 0840 and 05, respectively. 
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LAN Alert Description Codes (VM) (VSE) 

The list that follows describes each alert by description code and provides the list of 
detail qualifier items that accompany the alert. See “Description of Detail Qualifier 
Items (VM) (VSE)” on page 547 for descriptions of the detail qualifier items. 


Code Type of Failure 


66 


67 


68 


69 


6A 


Open Failure: Token-Ring Lobe 


Description: The adapter detected a problem on its lobe during the wrap-test 
portion of the insertion process. The insertion process did not complete. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Open Failure: Token-Ring Fault Domain 


Description: The adapter detected a beaconing condition on the ring during 
the insertion process. The insertion process did not complete. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Open Failure: Token-Ring Duplicate Station Address 


Description: The adapter detected the presence of a station with its 
address on the ring during the insertion process. The insertion process did 
not complete. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Open Failure: Token-Ring Remove Command Received 


Description: The adapter received a Remove Ring Station MAC frame 
during the insertion process. The insertion process did not complete. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Open Failure: Token-Ring Lobe 


Description: An error was detected during the insertion process that is not 
defined in the previous alerts. These conditions are not expected to occur, 
so they are included within one alert definition. The insertion process did not 
complete. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 
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Adapter Error: Local Token-Ring Adapter 


Description: A hardware error in the reporting station's adapter has 
occurred. The adapter is now inoperable. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Wire Fault: Token-Ring Lobe 


Description: The reporting station's adapter detected a wire-fault condition 
on the ring. . | 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Auto Removal: Token-Ring Lobe 


Description: The reporting station's adapter has left the ring as part of the 
beacon automatic-recovery process. That is, the reporting station's adapter 
was a member of the beacon fault domain. The station removed itself from 
the token ring and ran a self test, which was unsuccessful. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Remove Command Received: Network Operator 


Description: The reporting station's adapter received a Remove Adapter 
command from a LAN manager and, as a result, left the ring. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Token-Ring Inoperative: Token-Ring Fault Domain 
Description: The ring has been beaconing for more than 52 seconds. 
Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Token-Ring Temporary Error: Token-Ring Fault Domain 


Description: The ring was in a beaconing state for less than 52 seconds and 
then recovered. The sender of this alert does not know whether a station 
removed itself from the token-ring to bypass the fault, or whether the fault 
was temporary. 


Detail data: 
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1. Channel unit address 
2. Command 
3. Error code. 


83 Link Error: LAN LLC Communications/Remote Node 


Description: The remote link station does not respond. The response timer 
(t1) has expired, causing the remote station to be polled. The retry count 
(n2) for the number of polls has been exceeded. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


84 Link Error: LAN LLC Communications 


Description: The remote link station sent a Disconnect Mode (DM) to the 
local link station. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


87 Software Program Error: LAN LLC Communications 


Description: The remote link station sent an SABME (set asynchronous bal- 
anced mode-extended) to the local link that had been previously initialized 
through an SABME-UA (unnumbered acknowledgement) exchange. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


AO Software Program Error: LAN LLC Communications 


Description: The local link station sent an unsupported frame or a frame that 
is not valid to the remote link station, which resulted in the remote link 
station returning a frame reject. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


A1 Software Program Error: LAN LLC Communications 


Description: The local link station sent an I-field when not permitted. That 
resulted in the remote link station returning a frame reject. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 
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Software Program Error: LAN LLC Communications | 


Description: The local link station sent a send sequence number that is not 
valid, which resulted in the remote link station returning a frame reject. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Software Program Error: LAN LLC Communications 


Description: The local link station sent an I-field that was too long, which 
resulted in the remote link station returning a frame reject. | 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Software Program Error: LAN LLC Communications 


Description: The remote link station sent an unsupported frame or a frame 
that is not valid to the local link station, which resulted in the local link station 
returning a frame reject. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Software Program Error: LAN LLC Communications 


Description: The remote link station sent an I-field when not permitted, 
which resulted in the local link station returning a frame reject. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Software Program Error: LAN LLC Communications 


Description: The remote link station sent a receive sequence number that is 
not valid, which resulted in the local link station returning a frame reject. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Software Program Error: LAN LLC Communications 


Description: The remote link station sent an I-field that was too long, which 
resulted in the local link station returning a frame reject. 


Detail data: 


1. Channel unit address 
2. Command 
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3. Error code. 
BE Configuration or Customization Error: Local System Operator 


Description: The local system operator made an error in the VTAM defi- 
nition. One of the following situations occurred: 


e A physical unit dialed in, and there were no more available lines defined 
in the LAN major node. 


e The activation of a line in a LAN major node caused the total number of 
active lines to exceed the maximum stations coded for the LAN major 
node. 


e A dial out was attempted that will cause VTAM to exceed the maximum 
stations defined for the adapter. If more than one user is connected to 
the adapter, then the maximum number of stations must include the total 
number of stations for all connections. 


Detail data: 


1. Channel unit address 

2. Reason code: 
04 Dial in line not available 
08 Maximum number of stations exceeded (line activation) 
09 Maximum number of stations exceeded (dial out). 


BF Communications Subsystem Failure: Communications Subsystem 
Controller Interface 


Description: One of the channel programs for the CETI group failed. 
Detail data: 


1. Channel unit address 
2. Channel status 
3. Sense. 


CO Communications Subsystem Failure: Communications Subsystem 
Controller Interface 


Description: A command to the adapter has reported an unsuccessful com- 
pletion or an asynchronous indication has been received from the adapter. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


C1 Communications Subsystem Failure: Communications Subsystem 
Controller Interface 


Description: Local area network support code detected an error. The error 
is not the result of a user definition. 


Detail data: 


1. Channel unit address 

2. Reason code: 
01 MAXDATA segmenting error 
02 Sequence error 
03 PIU is not valid 
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05 Adapter input is discarded 
06 CETI architecture violation 
07 Unexpected SABME or XID received. 


Configuration or Customization Error: Local System Operator 


Description: The local system operator has made an error in the VTAM defi- 
nition. A local or remote node address that is not valid was specified. Either 
the SAP address or the MAC address is not valid or not recognized, or the 
station is not on the ring. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Configuration or Customization Error: Local System Operator 


Description: The local system operator has made an error in the VTAM defi- 
nition. The maximum data size is too large or is not valid. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Configuration or Customization Error: Local System Operator 


Description: The local system operator has made an error in the VTAM defi- 
nition. The service access point (SAP) address on the PORT statement is 
already in use. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Configuration or Customization Error: Local System Operator 


Description: The local system operator has made an error in the VTAM defi- 
nition. The number of stations specified is not valid on the PORT statement 
or the number of lines defined in the LAN major node is too large for the 
adapter. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Warning: Single Station on the Ring 
Description: The adapter has opened and it is the only station on the ring. 
Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 
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C7 Configuration or Customization Error: Local System Operator 


Description: The local system operator has made an error in the VTAM defi- 
nition. The station that is being activated as a LAN resource is not defined 
to VTAM as LAN-capable. 


Detail data: 


1. Channel unit address. 


Description of Detail Qualifier Items (VM) (VSE) 
Channel unit address This is the channel unit address specified on the PORT 
statement that defines a CETI group. 


Command This is the command that was processed when the alert 
was reported. Commands are used by VTAM LAN 
support to communicate with the adapter. See 
“Command Values Reported in Trace Entries (VM) 
(VSE)” for more about commands used by LAN support. 


Error code This is the completion status code that is associated with 
the command. 

Channel status This is the channel status that is reported for a failing 
CET! channel program. 

Sense This is the sense that is reported for a failing CETI 
channel program. This value may be 0 if no sense data 
is available. 

Reason code This is the reason code for the failure reported by the 


alerts with description codes of BE and C1. See the 
listing of those description codes for explanations of the 
values reported. : 


Command Values Reported in Trace Entries (VM) (VSE) 

Table 33 describes the command values reported in trace entries. VTAM LAN 
support and token-ring LANs attached through the ES/9370 controller use these 
commands to communicate. 


Note: Token-ring LANs attached through the IBM 3172 Interconnect Controller do 
not use these commands. 


Table 33 (Page 1 of 2). Command Value Descriptions 


Command 

Value Description 

810000 Set network parameters 

040COD Activate VTAM's service access point 

04CCOD 

040COE Deactivate VTAM's service access point 

04CCOE 

040COA Cause the subsystem to send test frames for remote station address 
04CCOA resolution and to establish a logical connection with a remote station 
040COB Cause the subsystem to break a logical connection with a remote station 
04CCOB 
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Table 33 (Page 2 of 2). Command Value Descriptions 


Command 
Value Description — 


040C20 Perform SNA exchange identification (XID) 
04CC20 
044C20 
048C20 


040D00 Perform SABME - UA exchange 
04CDO00 
044D00 
048D00 


040D01 Perform DISC - UA/DM exchange 
04CD0O1 
044D01 


040D10 Send and receive normal data 
04CD10 
044D10 


040D50 Control the flow of data to and from a remote station 
04CD50 | 
044D50 


040660 Send and receive test frames to perform VTAM link level 2 (LL2) test 


04C660 


044D1A Pass asynchronous status and statistics 
024D1A 


The commands in the table are in the form: 
XXYXXX 


where 


XX_xxx is the command identifier and 
y is the command type. 


The command types for y and the direction of flow are: 


y Command Type Direction of Flow 

0 Request From VTAM LAN support to the subsystem 
4 Indication From the subsystem to VTAM LAN support 
8 Response to an indication From VTAM LAN support to the subsystem 
C Confirmation of a request From the subsystem to VTAM LAN support 


Note: The set network parameters command flows as both a request and a confir- 
mation. It is always shown as 810000 in the VTAM trace command fields. 
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Messages Issued for 3745 Bus Switching 


A 3745 can be configured with one or two CCUs. For twin-CCU 3745s, NCP V5 
supports the two CCUs as independent communication controllers. 


A twin-CCU 3745 can be operated such that, if one of the CCUs fails, the mainte- 
nance and operator subsystem (MOSS) switches the I/O controller (IOC) buses 
from the failing CCU to the active CCU. The operator can then activate all or part 
of the resources of the failing CCU to the other CCU. 


The bus-switch can also be performed at the operator's request. 


If the bus-switch occurs in the middle of a VTAM channel operation, such as a 
Read or a Write, VTAM issues messages !ST8811 and IST882I. 


Message IST881I: Message !ST8811 tells the operator that VTAM either was 
unable to contact a link station, or lost contact to a link station. 


This message is issued for one of the following reasons: 


e A bus is being switched from one CCU to the other. 
e A dump or load is being done on another channel. 
e A dump or load is being done by a local disk. 


When the link station becomes available (as indicated in other messages), VTAM 
resumes CONTACT processing. 


To terminate CONTACT processing before the link station becomes available, issue 
a VARY INACT,FORCE command to deactivate the link station. 


Message IST882I: Message IST882I tells the operator that VTAM is waiting for a 
device end from the link station identified in message IST8811. 


You should check to see if the link station is online. If it is, then there is a possi- 
bility that NCP is being dumped or loaded over another channel adapter, and no 
further action is necessary. 


Note: If the link station is not operating, not physically connected, or not online, 
VTAM never receives the device end. In those cases, you should issue a VARY 
INACT,FORCE command to deactivate the link station. 


Hardware Error Recording 


_ During error recovery processing (ERP), VTAM writes outboard recorder (OBR) 
records and miscellaneous data records (MDRs) to LOGREC or 
SYSREC. OBR records are written for hardware errors on channel-attached 
devices. ( {JJ OBR records are written for communication adapter-attached 
devices as well.) MDR's or alert's are written for hardware errors on NCP-attached 
devices. See “Recording NMVT Alerts in LOGREC” on page 539 for more informa- 
tion on MDRs. 


EREP formats and prints the LOGREC or SYSREC data set. 


OBR records contain information about the following: 


e Sense and status data on all channel-attached devices 
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e Failures on teleprocessing devices 
_¢ Temporary or intermittent failures on I/O devices 
e End-of-day requests 
e Permanent channel and device errors (unrecoverable errors and unit checks). 


Permanent error records show the date, time, logical unit name, type of record, 
contents @? counters, failing CCW, channel device name, CSW, sense information, 
device type, and flags. The time field shows the time at which the permanent error 

occurred. 


Counter overflow and end-of-day records show the date, time, logical unit name, 
type of record (counter overflow or end-of-day), contents of counters, channel or 
unit address, and device type. The time field shows the time at which the counter 
overflow or end-of-day error occurred. 


Counter overflow records are written when the temporary error counter or a device 
statistics table counter is about to overflow. VTAM maintains a counter for each 

channel-attached device. This counter keeps track of temporary errors. Counters 
of unit check errors by error type are also maintained in the device statistics table. 


End-of-day records are written whenever a VARY INACT command is entered for a 
link or channel. 


MDRs contain the following information: 


e Statistics on the overflow of error counters for communication controllers 
e Record maintenance statistics (RECMS) RUs 
e Permanent errors on NCP-attached devices. 


See the EREP entry in Table 80 on page 1165 to determine what book describes 
how to print and interpret MDR and OBR records. 


Logical Unit Connection Test (IBMTEST) 


You can enter the IBMTEST command from a terminal to find out whether that ter- 
minal can communicate with its owning SSCP. When you use the IBMTEST 
command, an unformatted RU is sent through the network path supporting the 
LU-SSCP session. This RU contains the IBMTEST command followed by the 
number of times the SSCP is to return (echo) the data to the logical unit and 
optional data (up to 247 bytes) being sent to the SSCP. 


You can increase the possibility of repeating an intermittent error that is hard to 
re-create by using IBMTEST, because you can request up to 255 echoes. You can 
also use it to determine whether a suspended LU-LU session is caused by either a 
hardware problem or by a problem with VTAM or an application program. 


Start this test with the following command: 


IBMTEST [nll,datal 


n | specifies the number of times the test data should be returned to 
the terminal. Specify n as a decimal number in the range 1-255. 
If no value is specified, a value of 10 is used by default. 
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data specifies the test data to be returned. Specify a character string of 
up to 247 characters, or the maximum message length of the ter- 
minal, whichever is smaller. If no test data is supplied, VTAM 
returns the following alphanumeric sequence: 


ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 


The IBMTEST command is valid only for terminals that use the USS LOGON 
format. The IBMTEST command must be defined in the USS table for that ter- 
minal. 


Note: This echo check does not verify that a terminal can establish a session with 
an application program in the host, because the session request may specify a dif- 

ferent network path than the one supporting the terminal's LU-SSCP session. If the 
requested path is unavailable, the session request is rejected, even though another 
path is available. 


lf there are any errors, the VTAM operator receives a message that contains the 
logical unit name associated with the terminal, the number of echoes that took 
place before the I/O error, and the error sense code. 


NCP Error Recording 


Patch Areas 


NCP error recording procedures create record maintenance statistics (RECMS) 
RUs that contain: 


e The initial error status that began the recovery process 
e The final error status that caused the permanent RECMS RU to be generated. 


RECMS Rus are created for each adapter check, program check, unresolved inter- 
ruption, counter overflow, I/O operation, and permanent line error. The RECMS 
RUs, which contain the miscellaneous data record (MDR), are sent to the VTAM 
host that owns the failing component. VTAM then records the MDR and writes the 
error information to the LOGREC or SYSREC file. 


Patch areas are available for VTAM, TSO/VTAM, and VSCS. 


VTAM Patch Area 

VTAM supplies a fixed patch area as a separate module. You can insert short 
service programs in this area to do maintenance-related functions. ISTPATCH is 
loaded into LPALIB during initialization of the operating system and is pointed to by 
the ATCPTCHA field in the ATCVT. The initial size of the patch area is 64 bytes, 
but you can change the size by link-editing a module named ISTPATCH of the 
desired size. 


Code the necessary change in the patch area. (ISTPATCH follows the same 
coding rules as other modules in LPALIB.) Then replace part of the failing code 
with a branch to the patch area, allowing you to bypass the failing code. 
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TSO/VTAM Patch Area (MVS) 

TSO/VTAM maintains a patch area in each module. The size of the patch area 
varies from module to module. If you need more information on using these patch 
areas, contact the IBM Support Center. 


VSCS Patch Area (VM) 

VSCS supplies a fixed patch area as a separate module. You can insert short 
service programs in this area to do maintenance-related functions. DTIPATCH is 
addressable from all VSCS code modules and is pointed to in the VSCS internal 
trace table header. 


VTAM Load Module List 
VTAM has a module list pointed to by ATCMDLST in the ATCVT. Each 16-byte 


entry in the list contains the following information in the form of 


XXXXXYYYYYYYAAAA, where 


e XXXXxX is the five significant characters of the module name 
e YYYYYYY is the PTF level (or Julian date if PTF level is not present) 


e AAAA is the address of the module in storage. 


Following is an example of some module list entries. 


C1iC9C3C1 
C1C9C3E5 
C1C9C3C9 
C1Cc9C3C9 
C1C9C3E7 
C1D7C3D2 
C1D7C3D9 
C1D7C3E2 
C1D7C3E2 
C1D7C3E4 


DOE4E8F9 
C340F9F1 
D6E4E8F9 
DOE4E8F8 
D440F9F1 
E440F9F1 
E440F9F1 
D940F9F1 
E4E4E8F8 
C5E4E8F9 


F3F7F4F4 
4BF2FOF4 
F4F2F8F9 
F4F2F9F3 
4BFOF8F9 
ABF2F9FS 
4BFOF9F2 
4BFOF8F9 
F5F3F8F7 
F2FOFLFS 


OOD8ACE8 
00D8C490 
0OD8A4C8 
00D87000 
00D8C288 
00D885C0 
00D8C190 
OOD8BE60 
00D8B9D8 
00D88E78 


You can use this module list table to 


*AICARUY93744.Q.Y* 
*AICVC 91.204.QD.* 
*AICIOUY94289 . QuH* 
*AICIRUY84293 .Q..* 
*AICXM 91.089.QBh* 
*APCKU 91.295.Qe.* 
*APCRU 91.092.QA.* 
*APCSR 91.089.Q.-* 
*APCSUUY85387 .Q.Q* 
*APCUEUY92915.Q..* 


e Determine issuer entries in VIT records 


e Search for save area base registers for modules that reside in LPA 


e Verify PTF levels of modules. 


Using Save Area Module Linkage Conventions—Subarea 


VTAM traces the flow of the execution of three VTAM components, SSCP, PUS, 
and LUS, by saving the work areas of modules in these components. The 
addresses of the module work areas are stored in either of these control blocks: 


e Network configuration services parameter list (NCSPL) 
e Request/response unit processing element (RUPE). 


In the RUPE the work area address can be found at RUPEDAP. 


In the NCSPL the 


work area address can be found at NCSPL.WKA. For the hex offsets of these 
fields, see VTAM Data Areas for MVS/ESA, VTAM Data Areas for VM/ESA, or 
VTAM Data Areas for VSE/ESA. 
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The NCSPL or RUPE work area contains the work and save areas for each module 
invoked for the command that the NCSPL or RUPE represents. The module work 
and save areas provide status information that pertains to both the processing of 
that command and any interruptions in the processing. 


This status information includes a record of which modules were entered, which 
modules returned to their callers, and which modules returned with a return code. 
Each module save area contains the 4th, 5th, 7th, and 8th characters of the module 
name and the register 15 value that includes a pointer to the last module called by 
this module. If this address is not in the dump, the module can be obtained by 
comparing the address to the addresses in VTAM's module list pointed to by 
ATCMDLST out of the ATCVT (see 552). 


The high-order byte of the register 15 save area also indicates the status of the last 
module called. (In 31-bit mode the address fills register 15, causing the status to 
overlay the high-order byte of the address in the register 15 save area.) 


Byte 

Value Status Indicated 

FE The called module has returned to this module without a return code. 
FF The called module has not returned to this module. 

nn The called module has returned to this module with a return code of nn. 
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Figure 79 is an example of what the NCSPL or RUPE work area might contain for 
modules invoked for a VTAM process using save area module linkage conventions. 
Using this convention, the save area contains a 4-byte module identifier, such as 
ACRT, at the location pointed to by register 13 for each entry in the chain. 


NCSPL/Rupe work area 


Next available work area 
ACRT 
ISTACCRT«—®ISTACCSD 
Register 14 (ISTACCSD still 
processing; 
Module called —_—— has not returned) 
| 


ISTACCRT 
work area 


ACSD 
ISTACCSD<—ISTACCQE 
Register 14 ISTACCSD<—®ISTACCQE 
(No return code) 
Module called <¢—___________» 
| 


ISTACCSD 
work area 
C—»> 
ACQE 
Register 14 
Module called 
| 

ISTACCQE 


| work area 


Figure 79. Save Area Module Linkage Conventions—Subarea 
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Using Save Area Module Linkage Conventions—APPN 


Figure 80 on page 556 shows the save area module linkage convention for APPN 
used by some VTAM modules. To determine the convention used for your module 
find the location pointed to by register 13 and check the 8-byte field preceding this 
address. If you find an 8-byte module name, such as ISTACCRT your module was 
coded using the save area module linkage convention for APPN. The first three 
characters will always be IST for a VTAM module. 


The addresses of the module work areas for modules using the save area module 
linkage convention for APPN are stored in process scheduling services (PSS) 
control blocks. The first word of the save area, pointed to by register 13 contains 
the pointer to the VTAM work area (VWA) header in the PSS. 


For the save area module linkage convention for APPN, the following save area 
format pointed to by the address in register 13 is used. 


Offset Contents 

X'-08' Module eye-catcher C'XXXXXXXX' 

X'+00' Address of ISTVWA 

X'+04' Backward save area pointer (to previous Save area) 
X'+08' Pointer to next available area 

X'+0C'... Registers 14 - 12 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Chapter 12. Using Other Problem Solving Tools 555 


Other Tools “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


PSS work area 


Next available work area 


ISTACCSD 


TT ISTACCRT«—®ISTACCSD 


ISTACCRT 
work area 


ISTA 
CCSD 
VWA base 
| 
ISTACCSD+—®ISTACCQE 
Register 14 | | ISTACCSD<—»ISTACCQE 
Module called +> 


ISTACCSD 
work area 


ISTACCQE 
work area 


Figure 80. Save Area Module Linkage Conventions—APPN 


VTAM Error Recording for Integrated Communication Adapter Lines 
(VM) (VSE) 


_\VTAM error recording procedures create record maintenance statistics (RECMS) 
RUs to record information about the following conditions: | 


e Recovered (temporary) switched SDLC link and station errors 
e Recovered (temporary) BSC link and station errors - 
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e Unrecoverable (permanent) switched SDLC link and station errors 
e Unrecoverable (permanent) BSC link and station errors 
e BSC 3270 sense/status data. 


RECMS RuUs are sent to a communication network management (CNM) application 
program, if one is designated to receive these RUs. 


For SDLC nonswitched lines, VTAM builds an NMVT instead of an RECMS. 
[4a VTAM also writes the RECMS records on SYSREC. 


See Table 80 on page 1165 to determine what book describes formats for RECMS 
RUs. 


Use EREP to edit and print the error data. See the EREP entry in Table 80 on 
page 1165 to determine what book describes how to edit and print error data. 
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Part 3. Diagnostic References 


Appendix A. VTAM Internal Trace (VIT) Record Descriptions ....... 567 
SE MUy Or VIAWMERS) +42 5.0.9 eo 4 DS Oa ew So Be SER Re eS 568 
ABND Entry for Abend SNAP Routine ....................04. 569 
ACA1 or ACI1 Entry for LU 6.2 Authorized |O or LU 6.2 TPIO (Part 1) .... 570 
ACA2 or ACl2 Entry for LU 6.2 Authorized !O or LU 6.2 TPIO (Part 2) .. 572 
ACAS or ACI3 Entry for LU 6.2 Authorized !O or LU 6.2 TPIO (Part 3) .. 573 
ACP1 or ACR1 Entry for LU 6.2 User Post or RPL Exit (Part1) ........ 574 
ACP2 or ACR2 Entry for LU 6.2 User Post or RPL Exit (Part2) ...... 576 
ACRC Entry for RPL6 Return Code .................-.. 0005. 578 
ACSN Entry for APPC Sense Code ..................2..0084 579 
ACU1 Entry for LU 6.2 User Exit (Part1) ..................... 580 
ACU2 Entry for LU 6.2 User Exit (Part2) .................0.. 581 
ADPx Entry for Adapter I/O (Part1) ...........0..... 0... .0005. 582 
ADP2 Entry for Adapter I/O (Part2) ............. 2.0.0.0 0048. 583 
ADSP Entry for Asynchronous Dispatch ...................... 584 
Ali Entry for Authorized 1O (Part1) ............. 2... .0. 2.0008. 585 
Al2 Entry for Authorized 1O (Part2)  ................ 0.0004. 587 
Al3 Entry for Authorized 1O (Part3) ................ 2.004. 588 
ALSx Entry for Adjacent Link Station Add, Delete, Replace, Select, Validate 589 
AP Entry for Signals Passed Between Components of the APPNCP  .... = 591 
A2 Entry for Requests and Responses witha RUPE ............. 593 
AREL Entry for Abend RELSTORE..................2.0.0.4. 594 
ATSK Entry for Attach ofa Subtask ...................0005., — 595 
ATT Entry for Attention 2... 0.0... 000. 596 
AXIT Entry for Asynchronous Exit ............ 0.000.000. 597 
BSPx Entry for ADD, DELETE, and FIND Macros ................ 598 
BSSx Entry for Add, Delete, and Find ....................0.. 599 
BSXx Entry for Add, Delete, and Find ....................... 600 
BTSK Entry for Begina Subtask ................ 00.000 0004 601 
CCI or CCO Entry for SSCP (RUPE--Part1) ................... 602 
CC2 Entry for SSCP (RUPE--Part 2) ...................0.2.. 603 
CCI or CCO Entry for SSCP (NCSPL--Part1) .................. 604 
CC2 Entry for SSCP (NCSPL--Part 2) .................006. 605 
CCl or CCO Entry for SSCP (not RUPE or NCSPL) .............. 606 
CFCE Entry for Coupling Facility Request Completion Exit ........... 607 
CFCN Entry for Coupling Facility Connection Service (Part1) ......... 608 
CFC2 Entry for Coupling Facility Connection Service (Part2) ....... 609 
CFDS Entry for Coupling Facility Disconnection Service (Part1) ..... .. 610 
CFD2 entry for Coupling Facility Disconnection Service (Part 2) ...... 611 
CFEE Entry for Coupling Facility Connection Event Exit ............ 612 
CFER Entry for Coupling Facility Connection Event Exit Response Service . 615 
CFFC Entry for Coupling Facility IXLFORCE Service .............. 616 
CFLS Entry for Coupling Facility IXLLIST Service (Part1) ........... 617 
CFL2 Entry for Coupling Facility IXLLIST Service (Part2) ......... 619 
CFNF Entry for Coupling Facility Event Notification ............... 620 
CFRB Entry for Coupling Facility Structure Rebuild Service .......... 621 
CFUS Entry for Coupling Facility User Sync Point Service ........... 623 
Ci or CO} Trace EnthleS: 2: 2s 6ioe8e24329444% 24s weed CE Rew SS 624 
Cl1 or CO1 Entry for SSCP (RUPE--Part1) .................. 625 
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-Cl1 or CO1 Entry for SSCP (NCSPL--Part1) ................. 626 


Cl1 or CO1 Entry for SSCP (not RUPE or NCSPL--Part1) ......... 627 
Cl2 or CO2 Entry for SSCP (RUPE--Part2) .................. 628 
Cl2 or CO2 Entry for SSCP (NCSPL--Part 2) ................. 629 
Cl2 or CO2 Entry for SSCP (not RUPE or NCSPL--Part 2) ......... 630 
Cl3 or COS Entry for SSCP (RUPE, NCSPL, or Not RUPE or NCSPL--Part 
OO), sexe ot Be ce Be ee Re ee ee ee 631 
Cl4 or CO4 Entry for SSCP (RUPE, NCSPL, or Not RUPE or NCSPL--Part © 
a ee ee ae ee ae ee ee ee ee eee eee ee ee 632 
CNA Entry for VCNSCMD Issued by Application ................. 633 
CNP1 or CNR1 Entry for ECB Posted or RPL Exit Dispatched (Part 1) ... 636 
CNP2 or CNR2 Entry for ECB Posted or RPL Exit Dispatched (Part 2) .. 638 
CNP3 or CNR3 Entry for ECB Posted or RPL Exit Dispatched (Part 3) .. 639 
CONN Entry forSHM Connect ............. 0.0... 00000 2 eee 640 
CPPG or CPPT Entry for CPPURGE or CPPOST Event (Part1) ....... 641 
CPP2 Entry for CPPURGE or CPPOST (Part2) ............... 643 
CPP3 Entry for CPPURGE or CPPOST (Part3) ............... 644 
CPP4 Entry for CPPURGE or CPPOST (Part4) ............... 645 
CPRC Entry for CPRC (Part 1): ...w ies be 8G Yee wha Se ew ee Ge 646 
CPR2 Entry for CPRC (Part2) ............. 0.000.000 2 2 eee 647 
CPR3 Entry for CPRC (Part 3) 6 c244. 404d 6 8de8 Sas byw dee 648 
CPTO Entry ior CPs Rely <.-89.44246¢5.54 0426 84 4.25264 bo 444 649 
CPWT Entry for CPWAIT Events (Part1) ......... Sh ae ee poe ete 2 650 
CPW2 Entry for CPWAIT (Part 2) ................2... 0004. 651 
CPW3 Entry for CPWAIT (Part3) ..... aotegeas: Se dece Gyo & Benge es Sf ne 652 
CPW4 Entry for CPWAIT (Part4) ................... 0008.5 653 
CRx Entry for ADD, DELETE, or FIND Control Block .............. 654 
DBx Entry for DBDELETE, DBQUERY, and DBUPDATE ............ 656 
DISC Entry for SHM Disconnect ............... 2.0.00. eee 657 
DLT Entry for Directory Services Locate (Part1) ................ 658 
DLT2 Entry for Directory Services Locate (Part2) .............. 661 
DSCD Entry for Discarded PIU Buffer (Part1) ..............00.2. 662 
DSC2 Entry for Discarded PIU Buffer (Part2) ................ — ~663 
DSP Entry for PAB Dispatch ................. 0.0.0.0. 0 000. 664 
DTSK Entry for Detach a Subtask ...................0.. .... 666 
ERP Entry for ClO Error Recovery ............. 0.0000 ues 667 
ERPx Entry for Error Recovery Procedures (Part1) ............... 668 
ERP2 Entry for Error Recovery Procedures (Part2) ............. 670 
ERPI or ERPL Entry for Error Recovery Procedures .............. 671 
ESC Entry forthe TPESC Macro ................. 0.0... .0004 672 
ETSK Entry for Exita Subtask ............ 0.0.00. 000 eee 673 
EXIT Entry forthe TPEXIT Macro ............... 2.0000 eee 674 
EXPN Entry for Buffer Pool Expansion .................0005., 676 
FBLK Entry for FREEBLK Macro (Part1) ..................04. 678 
FBL2 Entry for FREEBLK Macro (Part2) .................0.. 681 
GBLK Entry for GETBLK Macro (Parti) ...................04. 682 
GBL2 Entry for GETBLK Macro (Part2) .................... 685 
GNAM Entry for GNAME Macro Invoked (Part1) ................ 686 
GNA2 Entry for GNAME Macro Invoked (Part2) ............... 687 
HlOx Entry for Halt I/O .. 2... 688 
IOP Envy iOF ral WO!: ae x 2.420 @ ec Gates deed. rbd di Gl ase cee A A 690 
INT Entry for Channel Interrupt for X.25 Port .................0.. 692 
INTx Entry for Channel Interrupt (Part1) ..................0.. 693 
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INT2 Entry for Channel Interrupt (Part2) ................... 694 
INTx Entry for Channel Interrupt (Part1) ..................0.. 695 
INT2 Entry for Channel Interrupt (Part 2) ................... 697 
INTx Entry for Channel Interrupt (Part1) ..................0.. 698 
INT2 Entry for Channel Interrupt (Part2) ................... 700 
INTP Entry for Channel Interrupt ...........0.... 2.0... 2.002048. 701 
lO1 Entry for TPIO Request (Part1) ................. 2.0.0. .004. 703 
lO2 Entry for TPIO Request (Part2) ............... 0.0.2 05. 705 
lO2 Entry for TPIO Request (Part2) .................0 205. 706 
lO3 Entry for TPIO Request (Part3) ©... ......... 2. 2-000.. 707 
lO3 Entry for TPIO request (Part3) ................ 0.0000. 708 
IPC Entry for Socket API Call Completion .................... 709 
IP! Entry for Socket API Call ............. 0... 0... 00.0008. 710 
IRBD Entry for IRB Dispatch ............ 0.000000 000 eee 711 
IRBX Entry for tAB Exit « <.« sePsck Os da Rae bbe eee eee Rae S 712 
LCSx Entry for LAN Channel Station Error (Part1) ............... 713 
LCS2 Entry for LAN Channel Station Error (Part2) ............. 717 
LCSM Entry for MACaddress for DATA SEND/RECEIVE ............ 718 
LICx Entry for LAN Interface Command ...................04.4 720 
LKEX Entry for TPLOCK Exclusive ............... 0.00000 05 723 
LKSH Entry for TPLOCK Shared ................0. 0.0.0 0040. 724 
ENIX EAU ep dee ieee dS a-o h he e 6 e ASS WE eS 725 
LOST Entry for Lost Trace Record ................ 0.000008 | 727 
LSNA Entry for Local SNA Record (Part1) .................0.. 728 
LSN2 Entry for Local SNA Record (Part2) .................. 730 
MIC Entry for MVS IUCV Macro Completion ................... 731 
MIE Entry for MVS IUCV External Interrupt .................... 732 
Mil Entry for lUCV API Call .........0.. 00.0000 0200 ee eee 733 
MPT Entry for IP Component Read or Write (Part1) .............. 734 
MPT2 Entry for IP Component Read or Write (Part2) ............ 735 
MSG Entry for Message Issued ......... 2... ee ee 736 
MSGS Entry for Message Sent (Part 1) ...................044 738 
MSG2 Entry for Message Sent (Part2) ..................4.. 739 
MU1 Entry for LU 6.2 Message Unit (Part 1) ................... 740 
MU2 Entry for LU 6.2 Message Unit (Part2) ................. 743 
MUS Entry for LU 6.2 Message Unit (Part3) ................. 744 
MU4 Entry for LU 6.2 Message Unit (Part4) ................. 746 
NMPT Entry for an Exception Condition(Part 1) ................. 747 
NMP2 Entry for Exception Condition (Part2) ................. 748 
NRSP Entry for Negative Response to PIU Request (Part1) ......... 749 
NRS2 Entry for Negative Response to PIU Request (Part2) ........ 750 
NSD Entry for NSIND Exit ........ 0.0.0.0... 000000000002 2, 751 
OPER Entry for Operator Command (Part 1) ................4.. 752 
OPE2 Entry for Operator Command (Part 2) ................. 753 
PIC Entry for Packet Interface .............. 0.000004 eee 754 
PIUVERUIV (RAR), ia oh ont a 8 ee hE Rhee oS ee ee Se ES 755 
PIUZ Entry (Pan 2). a tac eek be ee hoe ee eee ee ae Bd 756 
PKTI or PKTO Entry for X.25 Packet Sent or Received (Part1) ........ 757 
PKTX Entry for X.25 Packet Sent or Received (Part2) ........ ... 758 
POST Entry for Post Waiting Event ................. 02.200. 759 
PROA or PROD Entry for Profile Add or Delete ................. 760 
QREQ Entry for Queued REQSTORE ....................004 761 
QRYL Entry for Query Language ..................2. 020004. 762 
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QUE Entry for Work Element Queuedto PAB .......... ats ceed 763 


QUEN Entry for Work Element Queued to Any Control Block ......... 765 
RACR Entry for LU 6.2 Invocation of RACROUTE ............... 766 
RCEx Entry for RCE Macro ........... 2... 0.0.00. eee eee ee 767 
RDSC Entry for RUPE Discard (Part1) ...................0.0.. 768 
RDS2 Entry for RUPE Discard (Part2) ..................0.. 769 
RE Entry om RPLiExXt «a@e¢s.b6o4.0s Shas ba ew ee eR eae 770 
RELS Entry for Release Storage ................ 0.0000 ee ee 772 
REQS Entry for Request Storage (Part1) .................... 774 
REQ2 Entry for Request Storage (Part2) .................4. 776 
RESM Entry for Resume Event Processing ..................0.. 777 
SCHD Entry for Schedule of PAB Dispatch .................... 779 
SIO Entry for Start /O for X.25 Port ..........0.. 0.00.00 005 a. 781 
SlOx Entry for Start /O (Part 1) ............0. 0.2.0.0 .0. 0000. 782 
SlO2 Entry for Start /O (Part 2) .......... 0.0.0.0 0.0000 ee 784 
SIOP Entry for Stan VO- 2 inc 6 owe Oe wae RS SAE Ee oe a Bs 786 
SOCx Entry for SOCTREE ADD, DELETE, FIND, and RELEASE Macros .. 788 
SPT Entry for SPT Macro Invoked (Part1) .................... 789 
SPT2 Entry for SPT Macro Invoked (Part2) ................0.. 791 
SRBD Entry forSRB Dispatch ............... 2.0.0.0 0000008 792 
SRBX:- Entry lor SHB EX « 6.03 4d-.08hseDiw eee SERS ee EEE RS 793 
SRTx Entry for SRTADD, SRTCHG, SRTDEL, SRTFIND Macros ....... 794 
SRT2 Entry forthe SRTADD Macro ................ 0.000. 795 
TGM Entry for APPN TG Management (Part 1) ................. 796 
TGM2 Entry for APPN TG Management (Part2) ............... 798 
TREx Entry for Routing Tree Build or Update .................. 799 
TRNM Entry for Translate Message (Part1) ................006. 801 
TRN2 Entry for Translate Message (Part2) .................. 803 
UE Entry for USER Exit (DFASY or RESP) .................... 804 
UE1 Entry for USER Exit (not DFASY or RESP, Part1) ............ 805 
UE2 Entry for USER Exit (not DFASY or RESP, Part2) ........... 807 
ULKA Entry for Release All Locks ................ 0.000000. 808 
UNLK Entry for Release aLock ............... 00.000. eae 809 
UP Entry for User Application Program Post ................... 810 
-VCC1 Entry for CNCB Queued (Part 1) ................0.0004 812 
VCC2 Entry for CNCB Queued (Part2) .................00.4. 814 
VCDQ Entry for Work Element Dequeued .................... 815 
VCP1 Entry for PICB Queued (Part1)  ..................025. 819 
VCP2 Entry for PICB Queued (Part2) ..................... 823 
VPST Entry for VPOST Macro ..... 1... ee 824 
VRSM Entry for Resume after VWWAIT ...................008. 825 
VTAL Entry for Allocate Storage ............. 0... 00002 eee 826 
VTFR Entry for Free Storage ........ 0... 0.0. ee ee 828 
VWAI Entry for VWWAIT Macro... ee 829 
WAIT Entry for TPWAIT Macro ............ 2... 0.0. eee ees 830 
XID Entry for Exchange ID (Part 1) .............. 0.0.2.0 000, 832 
X|ID2 Entry for Exchange ID (Part2) ...................... 833 
XPST Entry for TPSWPST Macro ..................2..000. . ~=©834 
Appendix B. Finding VTAM Buffer Pools (VM, VSE) ............ 837 
Finding VTAM Buffer Pools (VM) ............... 0.00000 eee 837 
Example: Finding LPBUF (VM) .................. 0.000056 838 


Finding VTAM Buffer Pools (VSE) ................. 0.02.02 0045 839 
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Example: Finding LPBUF (VSE) ..................0.20005. 841 
Relative Locations of VTAM Buffer Pools (VSE) ................. 842 
Appendix C. First Failure Support Technology (FFST) Probes (MVS)(VM) 845 
FFST Probe: INGeX 2.5.6 420 444 See SER CERES OE ewe EE EAS OSS 845 
FFST Probe Information ............ 0.0000 cee ee 846 
FFST Probe Naming Convention .............. 0.00000 eee 846 
FFST Probe Descriptions ......... 0.0.0... ee 847 

Configuration Services Probes .............. 0.00000 eee 847 

Control Operator Probes ........... 0... 000 pee es 848 

Coupling Facility Services Probes (MVS) ..................5. 849 

Dependent LU Server Probes .................. 2.000008. 851 

Directory Services Probes ............. 0.0000 ee eee ene 852 

IP Network Access Probes (MVS) ...................2 008. 859 

LU Network Services Probes ............... 00000 eeee 860 

Management Services Transport Probes ................... 860 

Network Resource Management Probes .................... 861 

Session Services Probes .............0. 0.0000. eee eee 861 

Session Services CP-CP Probes ................ 0.000008 | 861 

Session Services LU-LU Probes ................ 2.002000 5 863 

Storage Management Probes ................ 2.0002 ene 869 

Topology and Routing Services Probes .................-.4. 869 

Trace Services Probes ...... 1.2... 0... . ce 870 

Transmission Subsystem Probes ................. 000004. 870 
Appendix D. Channel Programs ......................-4. 873 
Channel Programs for Channel-Attached Type 2 and 4 Physical Units .... 874 

Channel Commands for Channel-Attached Type 2 and 4 Physical Units . 875 

Channel Program Sequences ............. 0.00 eee eee 877 

- PUNS-Related Channel Programs ...........0 2.0... 00 0 eee 880 
Channel Programs for Channel-to-Channel Adapters (CTCA), Multipath 
Channels (MPC), and APPN Host-to-Host Channels ............. 881 

Channel Programs for Activating the CTC Connection ............ 881 

Channel Commands for Channel-to-Channel (CTC) Adapters. ....... 884 

XID Channel Program (X-Side) ...........0.. 00.000 eee 885 

XID Channel Program (Y-Side) ............. 0.00002 ee eee 886 

Channel Programs for CTC Data Transfer: (Blocking Protocol) ....... 887 

Channel! Programs for Multipath Channel (MPC) ............... 895 

Channel Programs for Activating the MPC Connection ........... 895 

Channel Commands for Activating the MPC Connection .......... 897 

Channel Programs for MPC Data Transfer .................. 897 
Channel Programs for Channel-Attached Non-SNA 3270 Devices ...... 899 

Channel Command Words .............. 2.0000 eee eee 900 

Channel Programs ...... 1... 901 
Channel Programs for a BSC Communication Adapter Line (VM) (VSE) ... 904 

Channel Commands... .... 1... 904 

/(O Scheduling Overview of BSC Lines .................... 904 

Channel Programs ...... 2... 2 2 905 

Enable WRITE Channel Program ................ 0.020008. 905 

Disable WRITE Channel Program... . ww we 906 

General Poll (Initial Read) Channel Progam ................. 906 

Continue READ Channel Program ................2..-22004 907 

Repeat READ Channel Program ...............2...22200. 907 
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Interrupt WRITE Channel Program ............2... 0.0.00 00% 907 
Reset WRITE Channel Program... ... 2... 2 ee 907 
Status READ Channel Program ................ 0.000004, 908 
Inquiry READ Channel Program... ww ww ee 908 
Sense Channel Program .... 2... 2. 908 
Initial Write (Conversational) Channel Program ................ 909 
Inquiry Write (Conversational) Channel Program ............2... 909 
Channel Program Finite State Machines forBSC Lines ........... 910 
Channel Programs for an SDLC Communication Adapter Line (VM) (VSE) . 911 
Channel Commands... .. 1... 911 
I/O Scheduling Overview of SDLC Lines .................... 912 
I/O Scheduling for PU Services .................0 2.000005 913 
I/O Scheduling for the Link Level2 Test .................... 913 
Cnannel Programs: «aw. ke kaa oo ES te ee oe aA ER a 913 
Autopoll Channel Program... 2. 1 2 913 
Read PIU Channel Program ...... 2... 2. ee 914 
Write PIU Channel Program... . 1... 2 ee 915 
Write Test Channel Program... dw ww 916 
Sense SCB Channel Program ............. 0.0000 eee eens 916 
Sense I/O Channel Program ...........0.0 0.000 eee ee ee 916 
Enable Line Channel Program ............ 0.0000 ee eens 917 
Answer Channel Program... ww 1 we 917 
Dial Channel Program gw ww we 918 
Write SDLC Control Channel Program ................20048. 919 
Read SDLC Control Channel Program ..................04. 919 
Disable Line Channel Program ............. 0.00.00 eee eee 920 
Primary XID Channel Program... . 2 2 2 ee 920 
Secondary XID Channel Program ..............0 02000 eae 920 
Link, Connection, and Physical Unit Finite State Machines (MVS) (VM) .. 921 
Hints for Common Errors: Finite States (VM) (VSE) ............. 922 
Appendix E. Network Flows ........... Reside eee aca ede see 925 
Generic BIND (GBIND) AMRUsS........... 2... ee ee 930 
Index of Generic BIND (GBIND) AMRU Flows ................ 930 
Resource Activation FlowS ......... 0... 00 ee ee 933 
Index of Resource Activation Flows ................0 005080. 933 
Session Establishment Flows ...........0. 00.0. eee ee es 949 
Index of Session Establishment Flows ..................04. 949 
Deactivation and Session Termination Flows ................... 976 
Index of Deactivation and Session Termination Flows ............ 976 
Error Detection and Recovery and SSCP Management Services ....... 1000 
Index of Error Detection and Recovery and SSCP Management Services 
RIOWS: gh ee Oo ok ew oe Pea ee PRE ee ee ee 1000 
Dial and Answer for X.21 Switched Lines (VSE) ................. 1011 
Index of X.21 Switched Lines Flows .................20004. 1011 
Appendix F. APPN Flows .................. 0.000005 eae 1013 
CP-GP Session FIOQWS: s.04% 4% 4444 wars ewe Ses AS aeneeES Sew 1018 
Index of CP-CP Session Flows ................ 0.000004. 1018 
Directory Services Flows ........... ute tr ia eyes are Nees 1028 
Index of Directory Services Flows ................. 0.00008. 1028 
Register Resource Flows ............. 0.00000 eee ees 1029 
Locate Resource Flows ........... 2... 00. eee es 1032 
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LU-LU Session: FIOWS: «4.624.454 ware eee eee ee es weed 1057 
Index of LU-LU Session Flows .............. 0.0000 eee nee 1057 
Dependent LU Server Flows .......... 2.0... 0.0.0. eee eens 1098 
Index of Dependent LU Server Flows .................008. 1098 
Single Subnetwork Flows ... 2.1... 2 1099 
Cross Subnetwork Flows ........0..0. 0.0.00 eee ee es 1117 
Appendix G. Control Point/Control Block (CPCB) Operation Codes’  .. 1127 
Appendix H. Storage and Control BlockiID Codes ............. 1137 
VTAM Control Block ID Codes ............. 0.0.00 eee ens 1137 
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Appendix A. VTAM Internal Trace (VIT) Record Descriptions 


This appendix contains the VTAM internal trace (VIT) record descriptions. The 
entries are listed alphabetically by entry name. 


Table 34 summarizes the VIT options and the records they create. 


Table 34. VIT Options and the Records — Create 


CFS LOCK TCP VCNS 
MVS. LMS | /MVS | 
= 


Notes: 


1. The **** (FFST), ABND, and LOST trace records are not activated by specific 
VIT options. They are activated as a result of exception conditions. 


2. The entries in boldface type are forced, that is, always traced even if they are 
not specified by the user. 


For more information on VIT options, see “Selecting Trace Options” on page 398. 
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*“«* Entry for VTAM FFST 


— Entry: | **** (FFST) 
VIT Option: © 7 None (Generated by VTAM) 
Event: | VTAM probe triggered 


_VIT Processing Module: |ISTRACTR (SNAP trace recording routine) 


Control is Returned to: ISTRACZE 


Applies to: 


The **** (FFST) trace record is written when VTAM disables the VTAM internal 
trace (VIT) to collect information for a probe that has been triggered. This entry is 
not associated with any VIT options but is recorded when an unusual condition trig- 
gers a probe instruction. | 


Ololejo/ojolejelojojolojejelojolajajalafafafafa{alajafafajasaya 
0} 142)3)4)5)6)7/8)9|A|Bi/C|DIE|F{O}1)2)314)5)6)7;/8|/9;A|BiC|DIE|F 


Byte (hex) Contents : 
00-03 Record ID: C'****' 


'VIT DISABLED FOR VTAM/FFST' 


04 Blank 
05—1E C'VIT DISABLED FOR VTAM/FFST' 
1F Blank. 
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ABND Entry for Abend SNAP Routine 


Entry: ABND 

VIT Option: None (Generated by SNAP routine) 

Event: Abend 

VIT Processing Module: ISTRACTR (SNAP trace recording routine) 
Control is Returned to: VTAM abend recovery routine (many possible) 
Applies to: 


This trace record is written when an abend occurs in a VTAM module. This entry is 
not associated with any VIT options but is recorded as an exception condition when 
an abend occurs. 


Note: lf the abend occurred as the result of a program exception in a channel 
end appendage, the request parameter header (RPH) address will be for the last 
PAB dispatch and not for the request parameter header (RPH) of the channel end 


ADDRESS | ADDRESS | ADDRESS 


appendage. 

Byte (hex) Contents 

00-03 Record ID: C'ABND' 

OC—OF Request parameter header (RPH) address or zero 
10-13 SDWA address or zero 


OOOO O/O/O/O/O/O/O/Oj;O/O/O/Ol 111i 1i1i1i1iljijlj1iij1jij1)i 
OILIZIZ/4/5/617 (8 9/AIBIC/DIE/F/O/1/213;4/5/617/8/9;AIBICID/E|F 
ABND | ABEND SDWA |ABEND PSW or 0 
CODE FLAGS » 
or 0 
04—07 Abend completion code 
08—0B PST address or zero 
14-17 SDWA flags or zero 
18-1F Abend PSW or zero. 
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ACAI or ACI1 Entry for LU 6.2 Authorized IO or LU 6.2 TPIO (Part 1) _ 


Entry: 
VIT Option: 
Event: 


VIT Processing Module: 
Control is Returned to: 


Applies to: 


ACA1 or ACI1 

APPC 

LU 6.2 authorized IO or LU 6.2 TPIO (Part 1) 
ISTRACAC 

ISTAICAR 


The ACA1 trace record shows LU 6.2 requests under the authorized path or LU 6.2 
requests not under the authorized path but issued by programs running under an 
authorized key. The ACI1 trace record shows LU 6.2 requests running under a 
normal path. | 


ACA] 
or 
ACI1 


Byte (hex) 
00-03 


04 


0}0)0)0)0 alole/olojojojolojel1{ajajafajafajajafafajaas2fafa 
Op 1j2j;3|4) 516; 7 (8/9 A|BIC DIE} FiO} 1)2)3)4/5)/6)7)8)9/A)BiC}DIE| F 


RPL C 
ADDRESS | N 


E|0/0 
X|P|P 
TIT 
1|6 


APPCCMD/USR FLD] SENSE 
U} U | AREA 
Ai F 
L} L 
Contents 
Record ID: 

e C'ACAI1' for authorized path 

¢ C'ACI1' for normal path 
ID is one of the following: 

¢ Primary address space ID 

This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 


05 Exit definition (RPLEXTDS) 
06 Option code byte 1 (RPLOPT1) 
07 Option code byte 6 (RPLOPT6) 
08—0B RPL address 
oC APPCCMD CONTROL operand value: 
X'10' ALLOC 
X'20' RESETRCV 
X'30' DEALLOC 
X'31' DEALLOCQ 
X'40' OPRCNTL 
X'50' PREPRCV 
X'60' RCVFMH5 
X'70' RECEIVE 
X'71' RCVEXPD 
X'80' REJECT 
X'90' SEND 
X'91' SENDEXPD 
X'AO' SETSESS 
X'BO' TESTSTAT 
OD APPCCMD QUALIFY operand value: 


X'01! 
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ABNDPROG 
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OE-OF 
10-13 
14-17 
18-1B 


1C-1F 
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X'02' ABNDSERV 
X'03' ABNDTIME 
X'04' ABNDUSER 
X'05' ANY 

X'06' CNOS 
X'07' CONFIRM 
X'08' CONFRMD 
X'09' DATA 
X'0A' DATACON 
X'OB' DATAFLU 
X'0C' DEFINE 
X'OD' DISPLAY 
X'OE' ERROR 
X'OF' FLUSH 
X'10' RQSEND 
X'11' SPEC 
X'12' ACTSESS 
X'13' DACTSESS 
X'14' ALLOCD 
X'15' IMMED 
X'16' CONWIN 
X'17' SESSION 
X'18' CONV 
X'19' SUSPEND 
X'1A' RESUME 
X'1B' RESTORE 
X'1C' SYNCBEG 
X'1D' SYNCEND 
X'1E' CONVGRP 
X'1F' WHENFREE 
X'20' IANY 

X'21' ISPEC 
X'22' ALL 

X'23' lALL 


User buffer length (RPLBUFL) for receive RPL or zero 
Address of SEND data or RECEIVE buffer 
APPCCMD flags (RPL6FLGS) or zero 
User field for LU 6.2 commands where CONTROL = either ALLOC or 
RCVFMHS5. CID for LU 6.2 commands where CONTROL = OPRCNTL 
and QUALIFY = either ACTSESS or DACTSESS. Zero for LU 6.2 
commands for which one of the following is true: 
e CONTROL = OPRCNTL, and QUALIFY = either CNOS, DEFINE, 
or DISPLAY 
e CONTROL = RECEIVE and QUALIFY = ANY 
e CONTROL = REJECT and QUALIFY = SESSION or CONVGRP 
e CONTROL = SETSESS and QUALIFY = RESUME 


Conversation ID for all other LU 6.2 commands 
Sense data (RPL6SNSO) or zero. 
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ACA2 or ACi2 Entry for LU 6.2 Authorized IO or LU 6.2 TPIO (Part 2) 


Entry: ACA2 or ACI2 

VIT Option: APPC 

Event: LU 6.2 authorized |O or LU 6.2 TPIO (Part 2) 
VIT Processing Module: ISTRACAC 

Applies to: 


The ACA2 trace record is a continuation of ACA1. The ACI2 trace record is a 
continuation of ACI1. 


4HH HHH Es alSiele 4HHH alPlalz elalalsle ala BRHEE HE 
dH b 4HHe “HER 617/18 


ACA2 {RETURN LOCAL LU PARTNER LU 
See NAME, 0, OR NAME, 0, OR 
description. | BLANKS BLANKS 


Byte (hex) Contents 
— 00-03 Record ID: 
¢ C'ACA2' for continuation of ACA1 
e C'ACI2' for continuation of ACI1 
04-07 Address of the issuer of the APPCCMD macro 
08—OF 
e When CONTROL=ALLOC or REJECT, and QUALIFY=CONVGRP, 
then 08—OB is the conversion group ID (CGID), and OC—OF is zero. 
e When CONTROL = ALLOC (except when QUALIFY = CONVGRP) 
or when CONTROL = OPRCNTL, and QUALIFY = either CNOS, 
DEFINE, or DISPLAY, then 08-0F is the mode name for LU 6.2 
commands. 
e When CONTROL = SETSESS or when CONTROL = REJECT, and 
QUALIFY = SESSION, then 08—-0F is the session instance identifier 
for LU 6.2 commands. 
10-17 Local logical unit name for LU 6.2 commands where CONTROL = 
ALLOC, or where CONTROL = OPRCNTL, and QUALIFY = either 
CNOS, DEFINE, or DISPLAY. 


Otherwise, this field contains blanks or zero. 

18-1F Partner logical unit name for LU 6.2 commands where CONTROL = 
ALLOC, or where CONTROL = OPRCNTL, and QUALIFY = either 
CNOS, DEFINE or DISPLAY. 


This field contains blanks or zero. when CONTROL=ALLOC or 
REJECT, and QUALIFY=CONVGRP. 
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ACA or ACI3 Entry for LU 6.2 Authorized IO or LU 6.2 TPIO (Part 3) 


Entry: ACA3 or ACI3 

VIT Option: APPC 

Event: LU 6.2 authorized IO or LU 6.2 TPIO (Part 3) 
VIT Processing Module: ISTRACAC 

Applies to: 


The ACAS3 trace record is a continuation of ACA2. The ACIS trace record is a 
continuation of ACI2. 


oltel}elteellslleleleeleelsteltellelealslalellelel 


ACA3 PARTNER NETID, 
0, OR BLANKS 


Byte (hex) Contents 
00-03 Record ID: 
¢ C'ACAS' for continuation of ACA2 
¢ C'ACI3' for continuation of ACI2 
04—17 Zero 
18—1F Partner network identifier for the LU 6.2 commands where CONTROL = 
ALLOC (except for CONTROL=ALLOC,QUALIFY=CONVGRP), or 
where control = OPRCNTL, and QUALIFY = either CNOS, DEFINE, or 
DISPLAY. Otherwise, this field contains blanks or zero. 
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ACP1 or ACR1 Entry for LU 6.2 User Post or RPL Exit (Part 1) 


Entry: ACP1 or ACR1 
VIT Option: APPC 
Event: LU 6.2 user post or RPL exit (Part 1) 


VIT Processing Module: ISTRACAC 
Control is Returned to: ISTAICPT and ISTAPCSX for ACP1 
ISTAPCSX and ISTAPCUE for ACR1 


Applies to: 


The ACP1 trace record is written when an ECB is posted. The ACR1 trace record 
is written when an RPL exit is dispatched. These records signal that the 
se rahe 1f 4 1 a aE aF ‘lg Ff 
f 3 He Hf He HF ah 
00-03 Record ID: 
04 ID is one of the following:. 
e Machine ID and Task ID 


APPCCMD macro has completed execution and show the data returned to the user 
are I]R}R}F}RPL C}Q APPCCMD|CONV ID} SENSE 
D|T|T)Dj| ADDRESS |N ; ; FLAGS |OR 0 DATA 
ACR! UjN|B OR 0 
NiCj2 
D 
e C'ACP1' for ECB posting 
e Primary address space ID 
e Task ID 


—-Aa a 


application program. 
Byte (hex) Contents 
¢ C'ACR1' for RPL exit dispatching 
This field is Zero if the ID is greater than X'FF'. 


05 APPCCMD returned indicators (RPL6RTUN) 
Bit Meaning 
cee. Schur FMH5 received indicator 
-.1.. .... LOGON received indicator 
el. ..-. SIGNAL received indicator 
06 VTAM return code (RPLRTNCD) 
07 VTAM feedback code (RPLFDB2) 
08—0B RPL address 
oc APPCCMD CONTROL operand value: 
X'10' ALLOC 


X'20' RESETRCV 
X'30' DEALLOC 
X'31' DEALLOCQ 
X'40' OPRCNTL 
X'50' PREPRCV 
X'60' RCVFMHS5 
X'70' RECEIVE 
X'71' RCVEXPD 
X'80' REJECT 
X'90' SEND 
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OD 


OE-OF 
10-11 

12-13 
14-17 
18-1B 
1C-1F 
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X'91' SENDEXPD 
X'AO' SETSESS 
X'BO' TESTSTAT 
APPCCMD QUALIFY operand value: 
X'01' ABNDPROG 
X'02' ABNDSERV 
X'03' ABNDTIME 
X'04' ABNDUSER 
X'05' ANY 
X'06' CNOS 
X'07' CONFIRM 
X'08' CONFRMD 
X'09' DATA 
X'OA' DATACON 
X'OB' DATAFLU 
X'0C' DEFINE 
X'OD' DISPLAY 
X'OE' ERROR 
X'OF' FLUSH 
X'10' RQSEND 
X'11' SPEC 
X'12' ACTSESS 
X'13' DACTSESS 
~X'14' ALLOCD 
X'15' IMMED 
X'16' CONWIN 
X'17' SESSION 
X'18' CONV 
X'19' SUSPEND 
X'1A' RESUME 
X'1B' RESTORE 
X'1C' SYNCBEG 
X'1D' SYNCEND 
X'1E' CONVGRP 
X'1F' WHENFREE 
X'20' IANY 
X'21' ISPEC 
X'22' ALL 
X'23' IALL 
Zero 


LU 6.2 primary return code (RPL6RCPR) 
LU 6.2 secondary return code (RPL6RCSC) 
APPCCMD flags (RPL6FLGS) 

Conversation ID or zero 

Sense data returned (RPL6SNSI) or zero. 
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ACP2 or ACR2 Entry for LU 6.2 User Post or RPL Exit (Part 2) 


Entry: 
VIT Option: 
Event: 


VIT Processing Module: 


Applies to: 


ACP2 or ACR2 

APPC 

LU 6.2 user post or RPL exit (Part 2) 
ISTRACAC 


The ACP2 trace record is a continuation of the ACP1 trace record. The ACR2 
trace record is a continuation of the ACR1 trace record. 


ECB 
ADDRESS 
OR 

EXIT 
ADDRESS 


Byte (hex) Contents 


le 4HHE AHEE lela 0} 1) 1 IB HE AHHE AHEE 
HHHe iH Flrloli HRHE al slala Alglelo 


RPL6 
ADDRESS 


RPL RPL 
AREA |RECORD 
LENGTH 


00—03 Record ID: 
C'ACP2' for continuation of ACP1 
C'ACR2' for continuation of ACR1 
04-07 ECB address for ACP2 
RPL exit address for ACR2 
08—OB RPL6 address 
oC APPCCMD CONTROL operand value: 
Bit Meaning 
X'10' ALLOC 
X'20' RESETRCV 
X'30' DEALLOC 
X'31' DEALLOCQ 
X'40' OPRCNTL 
X'50' PREPRCV 
X'60' RCVFMH5 
X'70' RECEIVE 
X'71' RCVEXPD 
X'80' REJECT 
X'90' SEND | 
X'91' SENDEXPD 
X'AQ' SETSESS 
X'BO' TESTSTAT 
OD Zero | 
OE Indicators for the type of information received or zero 
Bit Meaning 
: er ae ae DATA 


576 VTAM V4R2 Diagnosis 


DATA_COMPLETE 
DATA_INCOMPLETE 
SEND 

CONFIRM 
DEALLOCATE 
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OF zero 


10-13 Address of SEND data or RECEIVE buffer (RPLAREA) 
14-17 RPL record length 


18-1B Conversation group ID (CGID) when CONTROL=ALLOC or RCVFMHS5; 
otherwise, zero 
1C—1F Zero. 
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ACRC Entry for RPL6 Return Code 


Entry: ACRC 

VIT Option: | APPC 

Event: APPCSNRC macro 

VIT Processing Module: ISTRACAC 

Control is Returned to: Issuer of the APPCSNRC macro 
Applies to: 


This trace record is written when an APPC module issues a macroinstruction to set 
an RPL6RC non-zero return code. 


mMozruinae 


| ae ee | 


; 
N 
V 
E 
R 
S 
A 
T 
I 
0 
N 


Byte (hex) Contents 
00—03 Record ID: C'ACRC' 
04 ID is one of the following: 
¢ Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 
05-06 Zero 
07 Instance indentifier in invoking module 
08—O0B Conversation ID 
OC-—OF Half-session ID 
10-13 Invoking module name 
14-17 Address of control block containing return code 
18-1B Return code (RPL6RC) 
18-19 Primary return code (RPL6RCPR) 
1A-1B Secondary return code (RPL6RCSC) 
1C—1F RPH address. 
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ACSN 


ACSN Entry for APPC Sense Code 


Entry: ACSN 

ViT Option: APPC 

Event: APPCSNRC macro 

VIT Processing Module: ISTRACAC 

Control is Returned to: Issuer of the APPCSNRC macro 
Applies to: 


This trace record is written when an APPC module issues a macroinstruction to set 
a non-zero sense code. 


oh lbh 4HEb HEHE aBHE le 
alsla HH lPlala ABE BAe Ae 


ACSN 
D 


MOoOezrodinware 


—_ 
=zOraArunm=<=Zzonm 


Byte (hex) Contents 


00-03 
04 


05-06 
07 

08-0B 
OC-OF 
10-13 
14-17 
18-1B 
1C-1F 


Record ID: C'ACSN' 
ID is one of the following: 
¢ Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 
Zero 
Instance indentifier in invoking module 
Conversation ID 
Half-session ID 
Invoking module name 
Address of control block containing sense code 
Sense code or internal return code 
RPH address. 
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ACU! Entry for LU 6.2 User Exit (Part 1) 


Entry: ACU1 
VIT Option: APPC 
Event: | LU 6.2 user exit (Part 1) 


VIT Processing Module: ISTRACAC 
Control is Returned to: ISTAPCUE 


Applies to: 


This trace record is written when an LU 6.2 user exit (either ATTN or TPEND) is 
dispatched. If both the API and APPC trace options are active, and a TPEND user 
exit is dispatched, VTAM generates user exit trace records for both API and APPC. 


0/0/0/0/0/0/0/0/0/0)O;O/0/O)O/O/ 1) 1) 1) 1/1/11) 1) 1) 1) 171) 1)1)1)1 
Oj 12/3/4516) 7 |8/9|AIBIC|DIE|F Oj 112)3) 4,5; 6; 7/89 A Bi C\|DIE\F 


PLU NAME SLU NAME OR 0 
OR | 


APPLICATION ID 


Byte (hex) Contents | 
00-03 Record ID: C'ACU1' 
04 ID is one of the following: 
| e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID | 
05 Exit code for user exit: 
X'0C' for ATTN 
X'OD' for TPEND 
06-07 Zero | 
08—OB The type of exit determines the value of this field. 


e For ATTN exit, the exit sub-type (CNOS, FMHS5, or LOSS) 
e For TPEND exit, byte 8 is the reason code: 
Code Description 
X'00! Standard HALT command issued to close the network 


X'04' HALT QUICK command or VARY INACT,| or F 
command issued for the application program name 


X'08' HALT CANCEL command issued or VTAM terminated 
~ abnormally | 


X'0C' Alternate application issued an OPEN ACB for the - 
same ACB this application has opened 


O0C—OF Zero 
10-17 PLU name for ATTN exit; application program ID for TPEND exit 
18—-1F SLU name for ATTN exit; zero for TPEND exit. 
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ACU2 Entry for LU 6.2 User Exit (Part 2) 


Entry: ACU2 

VIT Option: APPC 

Event: LU 6.2 user exit (Part 2) 
VIT Processing Module: ISTRACAC 

Applies to: 


This trace record is a continuation of the ACU1 trace record. 


OOOOH; O;O/O;OO;O;O/O;O;O;O;DTiL)LiLyLiLiL)Vpapayajpayajayay. 

0) 1;2/3;4;5/6)7)8;9{/AIBi CDE; F/O; 1)2)3);4)5)6}7); 8; 9;AIB C|DI EF 

ACU2 | EXIT MODE NAME OR 0 NETID OR 0 
ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C'ACU2' 
. 04-07 Exit address 
08—OF Mode name for ATTN exit; zero for TPEND exit 
10-17 Zero 
18—1F Network identifier for ATTN exit; zero for TPEND exit. 
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ADPx Entry for Adapter I/O (Part 1) 


Entry: ADP!i, ADPO, or ADPA 
VIT Option: ClO | 
Event: Adapter I/O (Part 1) 


VIT Processing Module: ISTRAC6T 
Control is Returned to: ISTTSC6B 


Applies to: 


This trace record is created when a data transfer with the Token-Ring Subsystem is 
started or completed. 


An ADPI record is written when an inbound transfer has been received from the 
subsystem. An ADPI trace entry may be followed by one or more ADP2 entries. 


An ADPO record is written when an outbound data transfer is complete. This entry 
always corresponds to a previous LICO entry. Use the TSCB field to correlate 
these entries. An ADPO trace entry may be followed by one or more ADP2 entries. 


An ADPA record is written when the subsystem acknowledges that an outbound 
data transfer is complete. This entry always corresponds to a previous ADPO 
entry. Use the TSCB field to correlate these entries. 


Q/0/0/O/O/O/O/O/O/O/O;/O;/O/O)/O;O/ 1) 1) 1) 2; 1) 1) 1) 1) 2)1)1)1)1)1)1)1 
0)1)2}3)4)5)6)7/8/9|A|BiC|DJ/E] F/O} 1)2)3)4)5/6)7/8/9)/A/B/C/DIE;F 


ADPI |1| CUA |TSCB NC C\A\I}PIF DATA FIELD 
ADPO |D ADDRESS | ADDRESS |B/C|N/{A/R 
ADPA I} K|DICIN 

| D) |XIKIT 


Byte (hex) Contents 
00-03 Record ID: 

C'ADPA' for an acknowledge record 

C'ADPI' for an inbound record 

C'ADPO' for an outbound record 
04 Machine ID and Task ID 

Wa Task ID 

05-07 Channel device name in EBCDIC (either a CUA or device number) 
08—OB TSCB address 
OC—OF NCB address 


10 Control block ID 

11 Index value acknowledged by subsystem 

12 Last index value presented to subsystem 

13 Last index value acknowledged by subsystem 
14 Index for the front pointer of the buffer ring 

15 Index for the end pointer of the buffer ring 


16-17 Zero 
18—1F Data field. 
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ADP2 Entry for Adapter I/O (Part 2) 


Entry: ADP2 

VIT Option: ClO 

Event: Adapter I/O (Part 2) 
VIT Processing Module: ISTRAC6T 

Applies to: 


This trace record is a continuation of the ADPI or ADPO entries. 

0/0 OHO O/O/O/O;O/O/O/O/OlO; LT LILI Li LiLIL di lLyiis1iiyijisili1 

0/1 AISI6/7/BIDIAIBICIDIEIFIO/1I2Z/3/4/5/6/7/8/9/AIBICIDIE|F 
DATA FIELD 


Byte (hex) Contents 
00-03 Record ID: C'ADP2' 
04-—1F Data field. 
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ADSP Entry for Asynchronous Dispatch 


Entry: ADSP 
VIT Option: PSS 
Event: Asynchronous dispatch 


VIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCAD 


Applies to: 


This trace record is written whenever PSS receives control because work has been 
scheduled (TREADY COND=VTAM). 


hee mPlals “BHP aBHE AREF 
alt alsa 4HHb Pali fia ABBE AEP 


ADSP PST FI F 
é ADDRESS |L}L 


Byte (hex) Contents 
00-03 Record ID: C'ADSP' 


TPPOSTD NORMAL TPPOSTD | NORMAL 


AOPrmn 
DO O> 
DO @ > 


© 
© 


04 Machine ID and Task ID 
Task ID 
05 Zero 


06-07 PST Flags (PSTFLG1) 
08—0B PST address 
le; Zero 

AOT Flag A 
oD Zero 

AOT Flag B 
OE-OF Zero 
10-13 Synchronous TPPOSTed queue (PSTSTPP) 
14-17 Synchronous normal queue (PSTSNRM) » 
18-1B Asynchronous TPPOSTed queue (PSTATPP) 
1C—1F Asynchronous normal queue (PSTANRMM). 
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Al1 Entry for Authorized IO (Part 1) 


Entry: 
VIT Option: 
Event: 


VIT Processing Module: 
Control is Returned to: 


Applies to: 


Alt 

API 

Authorized IO (Part 1) 

ISTRACAP 

ISTAICIR for; ISTOCCSM for: 

SEND INQUIRE 

RECEIVE INTRPRET 

RESETSR RCVCMD 

SESSIONC SENDCMD 
SETLOGON 
SESSIONC (BIND) 
SIMLOGON 
OPNDST 
REQSESS 
OPNSEC 
TERMSESS 
CLSDST 


Alt 


This trace record shows API requests under the authorized path or API requests 
not under the authorized path but issued by programs running under an authorized 
key. The API routine ISTAICIR or ISTOCCSM writes the entry and then queues 
the RPL to the correct PAB. For an explanation of the RPL fields, see VTAM Data 
Areas for MVS/ESA or VTAM Data Areas for VM/ESA. 


Byte (hex) 
00-02 
03 


{4 


Contents 
Record ID: C'AI1' 
RPL request type (RPLREQ) 
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SETLOGON 
SIMLOGON 
OPNDST 
CHANGE 
INQUIRE 
INTRPRET 
CLSDST 
SEND 
RECEIVE 
RESETSR 
SESSIONC 
SENDCMD 
RCVCMD 
REQSESS 
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Alt 


04 


05 
06 
07 


08—0B — 


OC-OF 
10 

11 

12 

13 

14 
15-17 
18-1B 


1C-1F 
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X'2A' OPNSEC 
X'2C' TERMSESS 
ID is one of the following: 

e Primary address space ID 

This field is zero if the ID is greater than X'FF'. 

e Machine ID and Task ID 
Exit definition (RPLEXTDS) 
Option code byte 4 (RPLOPT4) 
Option code byte 1 (RPLOPT1) 
RPL address 
NIB address or CID 
Third byte of RH (RPLRHS3) 
Send/receive type (RPLSRTYP) 
VTAM flags (RPLVTFL1) 
Post/respond flags (RPLVTFL2) 
RU chain position (RPLCHN) 
RU control codes (RPLCNTRL) 
VTAM options (RPLOPTC2, which corresponds to RPLOPTS5 through 
RPLOPTS8) (See Appendix E, “Control Block Formats and DSECTs” in 
VTAM Programming for additional information.) 
VTAM options (RPLOPTC3, which corresponds to RPLOPT9 through 
RPLOPT12). (See Appendix E, “Control Block Formats and DSECTs” 
in VTAM Programming for additional information.) 
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Al2 Entry for Authorized |O (Part 2) 


Entry: Al2 

VIT Option: API 

Event: Authorized IO (Part 2) 
VIT Processing Module: ISTRACAP 

Applies to: 


This trace record is a continuation of the Al1 entry. It shows additional information 
about the PLU and SLU in a session established or terminated by a SIMLOGON, 
OPNDST, CLSDST, REQSESS, OPNSEC, or TERMSESS macroinstruction. This 
information includes some of the parameters exchanged and the names of the PLU 
and SLU. 


NAME (if available) 
(if available) 


Byte (hex) Contents 

00-02 Record ID: C'AI2' 

03 Zero 

04—07 Address of the issuer of the macro 

08—OF For SIMLOGON, OPNDST, CLSDST, or REQSESS: Logon mode 
name (NIBLMODE) or zero if the NIB is not available 


For OPNSEC or TERMSESS: Zero 
10-17 Application LU name if available 
18—1F Partner LU name if available. 
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Al3 


Al3 Entry for A 
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uthorized IO (Part 3) 


Entry: Al3 

VIT Option: API 

Event: Authorized IO (Part 3) 
VIT Processing Module: ISTRACAP 

Applies to: 


This trace record is a continuation of the Al2 entry. It shows additional information 
in a session established or terminated by a SIMLOGON, OPNDST, CLSDST, 
REQSESS, or OPNSEC macroinstruction. 

0 


slaeflsieleltelsteetelsielelasissiaela 


AI3 ADDRESS| TARGET LU NETID| TARGET LU NAME 
| (if available) 
. | OR @ 


Byte (hex) Contents 
00-02 Record ID: C'AI3' 


1lifili1{ifalili 
8ID|AIBICIDIE|F| 
PARTNER LU 
NETID 
(if available) 


03 Zero 
04-07 For SIMLOGON, CLSDST, or REQSESS: Address of user data 
(RPLAREA) | 


For OPNDST or OPNSEC: Address of BIND (NIBNDAR) or zero if the 
NIB is not available 
08-—-OF Target LU network identifier (when for CLSDST PASS). 
Byte (hex) Contents 
08—09 Count of node initialization blocks (NIBs) in NIB list (when 
not for CLSDST PASS). 
0A-0B Count of node initialization blocks (NIBs) in NIB list with 
NIBRPARM=0 (when not for CLSDST PASS). 
10-17 Target logical unit name, if available, or zero 
18-1F Partner LU network identifier, if available. 
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ALSx Entry for Adjacent Link Station Add, Delete, Replace, Select, 


Validate 


Entry: ALSA, ALSD, ALSR, ALSS, or ALSV 

VIT Option: SSCP 

Event: ALSLIST macro 

VIT Processing Module: ISTRACSC 

Control is Returned to: Module invoking the INTRACE macro that caused the 
record to be produced. 

Applies to: 


The adjacent link station (ALS) trace record contains information about the adding, 
deleting, replacing, selecting, or validating of an adjacent link station. 


COACH ACHACHECHECHECHECHECHACHECHECHECHECH(CIDC HOSP GU S000 C0 0000000000000 000 umm 
0/1/2)/3/4)516/7/8/9/A|BICIDIE| F/O} 1)2/3|4)5/6)7/8)9)A|B\C/DJE|F 
Byte (hex) 


NEWALS RETURN |CDRADDR OLDALS 
or ADDR or 0 
SELALS or 
or 0 0 and PUADDR 
00—03 Record ID: 


e C'ALSA': Add an adjacent link station 
e C'ALSD': Delete an adjacent link station 
e C'ALSR': Replace an adjacent link station 
e C'ALSS': Select an adjacent link station 
e C'ALSV': Validate an adjacent link station 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID : 
05 Return code from ALSLIST macro invocation 
06 Session control block identifier or 0 
07 Flags(from the following list): 
Bit Meaning 
Vics aes The type of add is dynamic. 
eae Autologon processing requested. 
ne eee Verify that the add is required. 
eee Waiting autologon requests should be processed. 
sae Zero 
as XX Connection type of PU whose address is given in 
PUADDR: 
00 Unknown 
01 LEN 
11 APPN 
08—OF ALS name or zero 
e For ALSA, ALSR, or ALSV: New ALS name passed on the add, 
replace, or validate function 
e For ALSD: Zero 


ah 
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e For ALSS: ALS name returned on the select function 
10-13 Return address of the caller of the ALSLIST function 
14-17 Address of the cross-domain resource passed to the ALSLIST function 
18—1F ALS name, PU address, or 0 
e For ALSA: Zero 
e For ALSD or ALSR: Old ALS name passed on the delete or 
replace function 
e For ALSS or ALSV: 0 and PUADDR 
— 18-1B: Zero 
— 1C-—1F: The PU address that is returned for the select or vaili- 
date function. 
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AP Entry for Signals Passed Between Components of the APPN CP 


Entry: AP 
VIT Option: SSCP 
Event: Signals passed between components of the APPN CP 


VIT Processing Module: ISTRACSC 
Control is Returned to: Module invoking the INTRACE macro that caused the 
record to be produced. 


Applies to: 


This trace record provides information about inbound request and responses which 
are processed by the CP. If this entry is associated with an event failure, non-zero 
sense code, it is generated regardless of the SSCP option. It is recognized as an 
exception code and is traced when the VIT is active. 


RETURN |SENSE FIRST 16 BYTES OF 
ADDRESS | DATA INTERPROCESS SIGNAL (IPS) 
OR 0 


Byte (hex) Contents 
00-01 Record ID: C'AP' 


02 To process anchor block (PAB) identification byte: 
Code (hex) ID 
'A' Advanced program-to-program communication (APPC) 
'C! Session services for CP-CP sessions (SSC) 
'D! APPN directory services (DR) 
'H' Half session (HS) 
‘|! Disk input or output 
re Session services for LU-LU sessions (SSL) 
'M' Management services transport (MST) 
'N' Node operator services 
'S' System services control point (SSCP) 
aa Topology and routing services (TRS) 
‘x! Transaction programs (XP) 
‘2! Dependent LU server (DLUS) 
Code (hex) ID 
'A' Advanced program-to-program communication (APPC) 
'C! Session services for CP-CP sessions (SSC) 
'D! APPN directory services (DR) 
'E' Directory services management exit 
PEL: Half session (HS) 
‘|! Disk input or output 
Pi Multiple domain server router 
nk Session services for LU-LU sessions (SSL) 
'M' Management services transport (MST) 
'N' Node operator services 
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AP 


03 


04 


05-07 
08—0B 


0C-OF 
10-1F 


592 VTAM V4R2 Diagnosis 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


a 1/O purge timer 

1S System services control point (SSCP) 
oT Topology and routing services (TRS) 
‘Xx! Transaction programs (XP) _ 

Le Dependent LU server (DLUS) 


From process anchor block (PAB) Identification byte. The codes are 
the same as byte 2. 
ID is one of the following: 

e Primary address space ID 

This field is zero if the ID is greater than X' tFET, 

e Machine ID and Task ID 

¢ Task ID 
Last 3 characters of the module invoking APSEND. (The characters 
KWN indicate that the module name is not known.) 
Address of the issuer of the APSEND module 
Sense code or zero 
First 16 bytes of the interprocess signal (IPS). For a list of interprocess 
signals, see VTAM Data Areas for MVS/ESA, VTAM Data Areas for 
VM/ESA, or VTAM Data Areas for VSE/ESA. 
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A2 Entry for Requests and Responses with a RUPE 


Entry: A2 

VIT Option: SSCP 

Event: Requests and Responses with a RUPE 
VIT Processing Module: ISTRACSC 

Applies to: 


This trace record is a continuation of the AP entry. 


OO/OO/O;O/O/O/O/O/O;O;O;O;O;O; A A;,Lp A; ApLPLPTiApApAylpdp;ayay. 
0} 1)2)3|4) 5/6) 7\/8)9;A|BiC)DIE}F/O}1)2)3)4)5)6)7)8) 9) A; Bi C|DJ EF 
| a2 30 MORE BYTES OF THE INTERPROCESS SIGNAL (IPS) 


Byte (hex) Contents 
00-01 Record ID: C'A2' 
02-—1F 30 more bytes of the interprocess signal. 
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AREL Entry for Abend RELSTORE 


Entry: AREL 
VIT Option: SMS 
Event: Abend RELSTORE 


VIT Processing Module: ISTRACSM 
Control is Returned to: ISTORAPR 


Applies to: 


This trace record identifies the buffers that are released by VTAM when a VTAM 
application program is terminated. 


lela ALE Alelele 4HEb ABR 
4HHE ‘elele 4HAh ARNE 


AREL PST BUFFER | RETURN 
ADDRESS | ADDRESS | ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C'AREL' 
04 ID is one of the following: 
¢ Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
05 Control block ID index value 
06-07 Zero 
08—0B PST address 
O0C-—OF Address of buffer being released 
10-13 Address of the caller of the abend RELSTORE routine 
14—1F Zero. 
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ATSK Entry for Attach of a Subtask 


Entry: ATSK 

VIT Option: PSS 

Event: ATTACH of a subtask 

VIT Processing Module: ISTRACPS 

Control is returned to: The module that issued the ATTACH 
Applies to: 


This trace record is written when a VTAM module issues an ATTACH macro to 
start another subtask. This record is generated after the ATTACH completes to 
ensure that completion information is included in the entry. Consequently, this 
entry can sometimes appear after the BTSK entry that is generated by the subtask 
it is attaching. 


Not all subtask events generate this entry. 


O/O/O/O/O/O/O;O;O/O/G;O;O;O; OO; LT; Li Li; 1pLpApLpaApaylpyajyij1y1 
0}1)2)3)4)5/6)7/8)9; ABC) DIE} F/O) 1),2/3)4)5)|6)7)8)/9;A)BiC|DIE|F 


I}R TCB 
ATSK |DIC TASK NAME ADDR 


Byte (hex) Contents 
00-03 Record ID: C'ATSK' 


ISSUER 
ADDRESS 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
05 Return code from the ATTACH macro 


06—07 Zero : 

08—OF Name of the subtask being attached 

10-13 TCB address returned from the ATTACH macro 
14-17 Zero 

18-1B Address of the issuer of the ATTACH macro 
1C—1F Register 1. 
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ATT Entry for Attention 


Entry: ATT 
VIT Option: ClO 
Event: Attention 


VIT Processing Module: ISTRACCI 
Control is Returned to: ISTTSCCA or ISTTSCLA 


Applies to: 


ATTI is written when an attention interrupt occurs for a channel-attached communi- 
cation controller or an SNA cluster controller. 


ATTL is written when an attention interrupt occurs for a channel-attached non-SNA 
device (device defined in a local non-SNA major node). 


ATTX is written when an attention interrupt occurs for a channel-to-channel attach- 
ment, including an IBM 3172 Interconnect Controller. | 


o|9/0)¢ Ee AHHE 
HHH Hise slala BRE 


ATT : $}C|O;}DEVICE |NCB FLAG 
C | ADDRESS: BYTES 

> W 

E 0 

P 


Byte (hex) Contents 
00-02 Record ID: C'ATT' 
03 NCB type: | for ICNCB, L for LDNCB, X for XCNCB 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID 
e Task ID 


05 Link station state (NCBLNKST) for |CNCB and LDNCB; station state 
(XCNSSFSM) for XCNCB 

06 CCW opcode or channel 

07 Zero 

08—OB Channel device name in EBCDIC (either a device address or device 
number) 


OC-—OF NCB address 

10-13 Flag bytes (NCBFLAGS) 

14 Zero 

15 I/O completion code (IOSCOD in the lIOSB) 
16-17 Sense data (IOSSNS of the IOSB) 

18-1F Channel status word from the IOSB. 
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AXIT Entry for Asynchronous Exit 


Entry: AXIT 
VIT Option: PSS 
Event: Asynchronous exit 


VIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCSX 


Applies to: 


This trace record is written whenever PSS exits to the operating system because 
there is no more work to do under a given task. 


ala 0/0/0 HHH HME stale ABE Nalela 
2|314 4HHE HEE Hate AHAE oe 


AXIT PST FIF 
é ADDRESS|L|L 


Byte (hex) Contents 
00-03 Record ID: C'AXIT' 


TPPOSTD| NORMAL | TPPOSTD | NORMAL 


4 
Om > 
Oo & 


OAM > rn 
DA © 
DO 


04 Machine ID and Task ID 
Task ID 
05 Zero 


O6—07 PST Flags (PSTFLG1) 
08—OB PST address 
oC Zero 

AOT Flag A 
OD Zero 

AOT Flag B 
OE-—OF Zero 
10-13 Synchronous TPPOSTed queue (PSTSTPP) 
14-17 Synchronous normal queue (PSTSNRM) 
18-1B Asynchronous TPPOSTed queue (PSTATPP) 
1C—1F Asynchronous normal queue (PSTANRM). 
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BSPx Entry for ADD, DELETE, and FIND Macros 


Entry: 


VIT Option: 


Event: 


BSPA, BSPD, or BSPF 
NRM 
BSBPCID ADD, DELETE, and FIND macros 


VIT Processing Module: ISTRACNR 
Control is Returned to: ISTTSCPU 


Applies to: 


This trace record is written when ADD, DELETE, and FIND operations are per- 
formed for the BSBPCID tree. It shows: 


e Key used for the invocation 
e Information from the boundary session block (BSB) indicating the state of the 
session. 


Use this entry to track activity on a session. 


BSPA 
BSPF 
BSPD 


Byte (hex) 


00-03 


04 


05 
06 


07 
08-0B 
OC-OF 
10-17 
18-1B 
1C-1F 
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Hal flelakt ae 
lala Hal 4HAh Abe 


oO 


moar MN 


P)/M}F/ ADDRESS | BSB PCID BSB RPH 
L}A}L ADDRESS FLAGS | ADDRESS 
UICIA 

R|G 

0)S 


Contents 
Record ID: 
C'BSPA' for BSBPCID ADD 
C'BSPF' for BSBPCID FIND 
C'BSPD' for BSBPCID DELETE 
ID is the primary address space ID (ASID). This field is zero it the 
ASID is greater than X'FF'. 
Primary logical unit (CEE)s state 
Macro return code 
Code Meaning 
X'00' Successful invocation 
X'04' Boundary session block (BSB) not found 
X'08' Duplicate input address 
X'12' Address not valid 
IP flags 
Address of the issuer of the macro 
Boundary session block (BSB) address 
Procedure-correlation identifier (PCID) 
Boundary session block (BSB) flags (FLAG1, FLAG2, FLAGS) 
Address of request parameter header (RPH) of module issuing the call. 
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BSSx 


BSSx Entry for Add, Delete, and Find 


Entry: BSSA, BSSD, or BSSF 

VIT Option: NRM 

Event: BSBSA ADD, DELETE, and FIND macros 
VIT Processing Module: ISTRACNR 

Control is Returned to: ISTTSCB2 

Applies to: 


This trace record contains information about BSBSA ADD, DELETE, or FIND 
macros issued by a VTAM module. 


Byte (hex) 
00-03 


04 


05-07 
08—0B 
OC-—OF 
10-11 
12-13 
14-17 
18-1B 
1C 

1D 


1E-1F 


AHHE on alesis aHHE 
dH ABE Hie HEHE ABHE vies 


RETURN SUBAREA SA 
ADDRESS | ADDRESS |A 


Contents 
Record ID: 
e C'BSSA' for BSBSA ADD 


e C'BSSD' for BSBSA DELETE 
e C'BSSF' for BSBSA FIND 
ID is one of the following: 
¢ Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID 
e Task ID 
Zero 
Address of the issuer of the macro 
Subarea address 
Subarea element address 
Rex element address 
Boundary session block (BSB) address or zero 
BSB Flags (FLAG1, FLAG2, FLAGS) 
PLU state 
Return code 


Note: It is not required that users of the product know the meaning of 
this internal VTAM return code. When required, the product support 
organization may use it to assist in internal flow diagnosis. 

Rex element address index. 
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Entry: 


VIT Option: 


Event: 


VIT Processing Module: 
Control is Returned to: 
Applies to: 


“Restricted Materials of IBM” 
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BSXx Entry for Add, Delete, and Find 


BSXA, BSXD, or BSXF 

NRM 

BSBREX ADD, DELETE, and FIND macros 
ISTRACNR 

ISTTSCB1 


This trace record contains information about BSBREX ADD, DELETE, or FIND 
macros issued by a VTAM module. 


AHH MBHEe AHAB ABHE 
afi AHAB Gals Mie SHAE 


RETURN 


Byte (hex) Contents 


00-03 


04 


1E-1F 
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Record |D: 
¢ C'BSXA' for BSBREX ADD 
e C'BSXD' for BSBREX DELETE 
e C'BSXF' for BSBREX FIND 
ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
Zero 
Address of the issuer of the macro 
LFSID 
PU element address 
CRA flags 
Zero 
Boundary session block (BSB) address or zero 
BSB Flags (FLAG1, FLAG2, FLAG3) 
PLU state 
Return code 


Note: It is not required that users of the product know the meaning of 
this internal VTAM return code. When required, the product support 
organization may use it to assist in internal flow diagnosis. 

Zero. 
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BTSK Entry for Begin a Subtask 


Entry: BTSK 

VIT Option: PSS 

Event: Begin a subtask 

VIT Processing Module: ISTRACPS 

Control is returned to: The subtask that is just starting 
Applies to: MVS 


This trace record is written when a VTAM subtask begins execution. This record 
can appear in the internal trace table before the ATSK entry for the ATTACH of the 
subtask. 


Some subtasks start without generating this entry. 


O/O/O;O/O;O;O;O/O/O;O;O;O;OlO;O; LT) A; LiL{LpLpLpapiylpljy1j1j1iay. 
0)1)2)/3)4/5) 6/7; 8/9;A; BI CDI E;F/0}1/2/3)4)5/6)7/8)9/A|BiC| DIE} F 


TCB REG 1 
BISK |I TASK NAME ADDR 
D 


Byte (hex) Contents 

00-03 Record ID: 'BTSK' 

04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05-07 Zero 

08—OF Name of the subtask that was just entered 

10-13 TCB address of the current subtask 

14-17 _ Entry point into the subtask 

18-1B ‘Zero 

1C-1F Contents of register 1 upon entry. 
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CCI or CCO Entry for SSCP (RUPE--Part 1) 


Entry: CCI or CCO 

VIT Option: SSCP 

Event: Requests/responses with a RUPE (Part 1) 

VIT Processing Module: ISTRACSC 

Control is Returned to: ISTINCCI for inbound processing 
ISTINCCO for outbound processing 

Applies to: 


This trace record provides information about outbound processing done by 
ISTINCCO and inbound processing done by ISTINCCI. ISTINCCO processes a 
request; ISTINCCI sends a response to the requester. 


If this entry is associated with an event failure (that is, the sense data is non-zero), 
this entry is generated whether the SSCP option is in effect or not. It is treated as 
an exception condition and, therefore, is traced whenever the VIT is active. 


eels iH qHBE ABE “AE 
4H ae HER BAe HAE 


CCI RETURN ORIGIN DESTINATION 
ADDRESS} NETWORK |NETWORK 
ADDRESS | ADDRESS 


Byte (hex) Contents 
00-02 Record ID: 
e C'CCI' for inbound processing 
e C'CCO' for outbound processing 
03 Flags 
e 80 = response RU 
e 40 = sense traced 
e 00 = request RU 
04. ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
° Task ID 


05 Control block ID=X'60' 
06 Flags (CPCBFL) 

07 Return code (CPCBRC) 
08—0OB Save area address 


OC—OF Save area ID (bytes 4, 5, 7, and 8 of the module name if available) 
10-13 Address of the issuer of the macro (CPCALL, CPEXIT, or CPWAIT) 
14-19 For sender, network address at origin (RUPE) 

1A-—1F For sender, network address at destination (RUPE). 
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CC2 Entry for SSCP (RUPE--Part 2) 


Entry: CC2 

VIT Option: SSCP 

Event: Requests/responses with a RUPE (Part 2) 
VIT Processing Module: ISTRACSC 

Applies to: 


This trace record is a continuation of the CCl or CCO (RUPE) entry. 


0}0/0/0)0)/0/0/0;0/0/0/0;0/0;/O/O)/1)1) 1) 1) 1) 2) 1) 171; 2)2)1)1}ijiyi 
0}1)2)3)4)5)/6)7)8)/9/A)B\C|DJE} F/O} 1)2)3)4)/5)6)7{8\9}A/B)C)DIE|F 


C FIRST 24 BYTES OF RU SENSE 


Byte (hex) Contents 
00-02 Record ID: C'CC2' 


03 Control block ID=X'54' 
04—1B First 24 bytes of RU 
1C—-1F Sense data or zero. 
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CCI or CCO Entry for SSCP (NCSPL--Part 1) 


Entry: CCI or CCO 

VIT Option: SSCP 

Event: Requests/responses for a NCSPL (Part 1) 

VIT Processing Module: ISTRACSC 

Control is Returned to: ISTINCCI for inbound processing 
ISTINCCO for outbound processing 

Applies to: 


This trace record provides information about outbound processing, which processes 
a request, and inbound processing, which sends a response to the requester. 


If this entry is associated with an event failure (that is, the sense data is non-zero), 
this entry is generated whether the SSCP option is in effect or not. It is treated as 
an exception condition and, therefore, is traced whenever the VIT is active. 


rib lb oan “HAE 
retell Fala HAE 


CCI RETURN | CPCB DESTINATION 
ADDRESS | OPCODE NETWORK 
ADDRESS 


Byte (hex) Contents 
00-02 Record ID: 
e C'CCI' for inbound processing 
e C'CCO' for outbound processing 
03 Flags 
e 80 = response RU 
e 40 = sense traced 
e 00 = request RU 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 


05 Control block ID=X'60' 
06 Flags (CPCBFL) 

07 Return code (CPCBRC) 
08—OB Save area address 


OC—OF Save area ID (bytes 4, 5, 7, and 8 of the module name if available) 

10-13 Address of the issuer of the macro (CPCALL, CPEXIT, or CPWAIT) 

14-17 CPCB operation code (see Appendix G, “Control Point/Control Block 
(CPCB) Operation Codes” on page 1127) 


18 WTD type 
19 Zero 
1A-1F Network address at destination. 
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CC2 Entry for SSCP (NCSPL--Part 2) 


Entry: CC2 

VIT Option: SSCP 

Event: Requests/responses for a NCSPL (Part 2) 
VIT Processing Module: ISTRACSC 

Applies to: } 


This trace record is a continuation of the CCl or CCO (NCSPL) entry. 
O/O/O/O;OO/O/O/O/O/O/O/O/O;O;O} 1] LjLjLyLj1j1jijajijip2jij1jiji 
0} 1)213)/4)5/6{7/8/9|A;B/CiDJE} F/O} 1)/213}4]5}6)7)8)9}A|BIC|DIJE|F 


CC2 jC} RDTE CPCB 
B} STATE | WID 
I 
D 


Byte (hex) Contents 

00-02 Record ID: C'CC2' 

03 Control block ID=X'60' 

04-07 RDTE state (in control block RPRE) 
08—0B CPCB WTD (first four bytes) 
OC-1F Zero. 
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CCl or sid Entry for SSCP (not RUPE or NCSPL) 


Entry: CCI or CCO 
VIT Option: | SSCP 
Event: Requests/responses for neither RUPE nor NCSPL 
VIT Processing Module: ISTRACSC 
Control is Returned to: ISTINCCI for inbound processing 
ISTINCCO for outbound processing 
Applies to: 


This trace record provides information about outbound processing, which processes 
a request, and inbound processing, which sends a response to the requester. 


If this entry is associated with an event failure (that is, the sense data is non-zero), 
this entry is generated whether the SSCP option is in effect or not. It is treated as 
an exception condition and, therefore, is traced whenever the VIT is active. 


CPCB CPCB CPCB 
ADDRESS|OPCODE |WORD 3 {WORD 4 


Byte (hex) Contents 
00-02 Record ID: 
e C'CCI' for inbound processing 
e C'CCO' for outbound processing 
03 Flags 
e 80 = response RU 
e 40 = sense traced 
e 00 = request RU 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 


05 Control block ID (Control block IDs are shown in Appendix H, “Storage 
and Control Block ID Codes” on page 1137.) 

06 CPCB flag (CPCBFL) 

07 Return code (CPCBRC) 

08—0B Save area address 


OC-OF Save area ID (bytes 4, 5, 7, and 8 of the module name if available) 

10-13 Address of the issuer of the macro (CPCALL, CPEXIT, or CPWAIT) 

14-17 CPCB operation code (see Appendix G, “Control Point/Control Block 
(CPCB) Operation Codes” on page 1127) 

18-1B CPCB word 3 (field WTDPTR) 

1C-1F CPCB word 4 (field CPCBPH). 
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CFCE 


CFCE Entry for Coupling Facility Request Completion Exit 


Entry: 
VIT Option: 
Event: 


CFCE 

CFS 

Complete Exit Driven for a Connection to Coupling 
Facility Structure 


VIT Processing Module: ISTRACCF 
Control is Returned to: ISTFSXCM 


Applies to: 


MVS 


This trace record is written when a previous request to access the coupling facility 
structure has completed asynchronously. 


CFCE ial 


Byte (hex) 
00-03 
04 


05 


06 
07 
08—O0B 
0C-—13 


14-17 
18-1B 
1C-1F 


1H HE HAE iFINE sla lal9 Nalelo 
alt HEE “HAF lslals ABBE nalelo 


ND ren 


— 


CFCON REQUEST RPH 

; ADDRESS DATA RETURN |REASON | ADDRESS 
N 

N 

N : 

E 

C 

T 

D 


Contents 

Record ID: C'CFCE' 

ID is the primary address space !D (ASID). This field is zero if the 

ASID is greater than X'FF'. 

Event flags: 

Bit Meaning 

Dede, eee This event applies to the new version of the structure. 

-l.. .... This event pertains to an invocation of the IXLLIST 
macro. 

.-l. ...- This event pertains to an invocation of the IXLCACHE 
macro. 

.-l1 .... This event pertains to an invocation of the IXLLOCK 
macro. 
. XXxx Zero 

Zero 

The connection identifier for the target of this event 

Connection control block (ISTCFCON) address 

The request data specified on the MVS macro invocation identified in 

the flags at offset X'05' of CFCE 

Return code for the MVS macro indicated at offset X'05' 

Reason code for the MVS macro indicated at offset X'05' 

Request parameter header (RPH) Address. 
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CFCN Entry for Coupling Facility Connection Service (Part 1) 


Entry: CFCN 
VIT Option: CFS 
Event: Invocation of the MVS macro IXLCONN 


VIT Processing Module: ISTRACCF 
Control is Returned to: ISTFSGCN 
Applies to: MVS 


This trace record is written when there is an attempted connection to the coupling 
facility structure with the IXLCONN macro. 


ah Allele aHBe ABE AHHE Ane 
Aelele rllali a\alals sl lala ABBE 


CFCN I CFCON INVOKER| MVS RPH 
“it ; ADDRESS ADDRESS |RETURN |REASON |ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C'CFCN' 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
05 Event flags: 
Bit Meaning 
Digi n coates The rebuild process is in progress for the structure. 
-1.. .... | The rebuild stop process is in progress for the structure. 
.-l. .... | This connection attempt caused the structure to be allo- 
cated. 
..-l1 .... A previously failed connection has been re-established. 
. 1... Full connectivity to the rebuild structure cannot be 


obtained. This bit is valid only if this connection attempt 
caused the structure to be allocated. This bit will be set 
only if IXLCONN was invoked during rebuild processing. 


.1.. The structure involved is volatile. 
..1. | VTAM did not process this event. 
wee eeeX §6©ZELO 
06 Zero 
07 Connection identifier or 0. If IXLCONN was successful, this field will 


contain the connection identifier assigned to this connection. Other- 
wise this field will contain the value zero. 

08—0B Connection control block (ISTCFCON) address — 

OC-—OF Zero 

10-13 The address of the invoker of IXLCONN 

14-17 Return code for the MVS macro IXLCONN 

—18-1B Reason code for the MVS macro IXLCONN 
1C—1F Request parameter header (RPH) Address. 
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CFC2 Entry for Coupling Facility Connection Service (Part 2) 


Entry: CFC2 

VIT Option: CFS 

Event: Invocation of the MVS macro IXLCONN 
VIT Processing Module: ISTRACCF 

Applies to: 


This trace record is a continuation of the CFCN entry. 


—1OO;OO/O;O/O/O/O;O/O;O/O;O;O;Oj; LiL A; Lj; LiLpApLjpLilyljpipajijiy. 
O1(2/3)4) 5/6) 7/8 /9jABIC|DjE; FiO; 1)2/3)4)5)6)7 (8; 9j;A;B/C|DiE|F 


CFC2 ACTUAL {MAXIMUM 
SIZE SIZE 
or 0 


Byte (hex) Contents 

00-03 Record ID: C'CFC2' 

04-07 The actual size of the structure allocated, or zero. If IXLCONN was 
successful, this field contains the actual number of 4K blocks allocated 
to the structure. 

08—OB The maximum structure size. This field contains the structure size, in 
4K blocks, defined in the active coupling facility resource management 
policy at the time this structure was allocated. 

OC-1F Zero. 
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CFDS — for Coupling Facility Disconnection Service (Part 1) 


Entry: CFDS 
VIT Option: CFS 
Event: Invocation of the MVS macro IXLDISC 


VIT Processing Module: ISTRACCF 
Control is Returned to: ISTFSUDC 


Applies to: 


This trace record is written when a connector disconnects from the coupling facility 
structure with the IXLDISC macro. 


0/0/0 4{}shab EE aBAE abe ‘lalela 
al3lals HHP 4Heb ABRE Hane ABBE 


Ci CFCON RETURN |RETURN |REASON |RPH 
ADDRESS ADDRESS | CODE CODE ADDRESS 


Byte (hex) Contents 
00—03 Record ID: C'CFDS' 


0 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05 Macro parameter flags 
Bit _ Meaning 
Ensign aces REASON(FAILURE) was epecitied for the request 
~XXX XXXX  ZE€FO 

06 Zero 

07 Connection identifier of the invoker of IXLDISC 


08—0B Connection control block (ISTCFCON) address 
OC-—OF Zero 

10-13 The address of the invoker of IXLDISC 

14-17 Return code for the MVS macro IXLDISC 
18-1B Reason code for the MVS macro IXLDISC 
1C-1F Request parameter header (RPH) Address. 
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CFD2 entry for Coupling Facility Disconnection Service (Part 2) 


Entry: CFD2 

VIT Option: CFS 

Event: Invocation of the MVS macro IXLDISC 
VIT Processing Module: ISTRACCF 

Applies to: MVS 


This trace record is a continuation of the CFDS entry. 


0)0)0/0/0)0)0;0/0)0/0)0 O;O;LiLpUpApyL{Dply~lpdylylyptyay1 
0} 1);2)3/4)5)6)7;8/9/A|B E|}F/0}1)2)3}4]5/6}7)8/9/A|BjC}D 


CFD2 CONNECTOR 
SPECIFIC 
DISCONNECT 
DATA 


0/0 1 
C}D F 


1 
E 


Byte (hex) Contents 

00-03 Record ID: C'CFD2' 

04—0B Connector Specific disconnect data 
0C-Tf Zero. 
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CFEE Entry for Coupling Facility Connection Event Exit 


Entry: CFEE 
VIT Option: CFS 
Event: Event Exit Driven for a Connection to a Coupling 


| Facility Structure 
VIT Processing Module: ISTRACCF 
Control is Returned to: ISTFSXEV 
Applies to: MVS 


This trace record is written when any of the following actions occurs: 


e A new connection is established to the coupling facility structure. 

e A connection to the coupling facility structure is terminated. 

e A-connector loses read/write access to the coupling facility structure. 

e A state change occurs for the coupling facility structure. 

e A user sync point is set by a connector to the coupling facility structure. 

e A user sync point has been confirmed by all connectors to the coupling facility 
structure. 


0/0/0/0/0/0/0)0)0/0)0/0)0/0)O)O) 1) 1) 1) 1) 1) 1) 1) 1) 1) 1)1)1)1) 14141 
0}1/2)3)4)5)6)7/8/9;A}BiC/DJE| F/O) 1)/2)3)4)/5)6)718)/9/A;BiC|D/E| F 


CFEE I} F)E|C}CFCON S}S|S|S|USER USER RPH 
D}L}V/O} ADDRESS | SEQ U}T|T|T|/DATA 1 |DATA 2 | ADDRESS 
E BiA 
N J|T 
T EVE 
C 
T 


ND > rm 
AaomMazaz 

2awtzazNnainr-7s 
Zznwnwvwvo 


oe 


Byte (hex) Contents 
00-03 Record ID: C'CFEE' 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
05 The event identifier in byte 06 determines the meaning of this field. 
Event flags: | 
e If byte 06 indicates a loss of connectivity event, use the following 
flags: 
Bit Meaning 
Leeds? acee’s The rebuild process is in progress for the structure. 
.1.. .... | The rebuild stop process is in progress for the struc- 
ture. : | 
..l. .... This event applies to the rebuild version of the struc- 
ture. 


.-l1 .... No action will be taken. MVS will determine action 
based on policy information. 
. XXxXx Zero 


e If byte 06 indicates an existing connection event, use the following 
flags: 
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06 


07 


CFEE 


Bit Meaning 

| Pee The rebuild process is in progress for the structure. 

.1.. .... | The rebuild stop process is in progress for the struc- 
ture. 


..1. .... This event does not pertain to a real connection but 
indicates that all existing connection events have 
been received. 

..l .... The connection identified is active. 
. 1... The connection identified does not have access to the 
structure. 

wees XXX Zero 


e If byte 06 indicates a disconnected or failed event, use the fol- 


lowing flags: 

Bit Meaning 

Vis8G: etacars The rebuild process is in progress for the structure. 

.1.. .... | The rebuild stop process is in progress for the struc- 
ture. 

..l. .... This event applies to the rebuild version of the struc- 
ture. 


..l .... | The connection disconnected abnormally. 
~ Xxxx Zero 


If byte 06 indicates a rebuild existing connection event, use the fol- 
lowing flags: 


Bit Meaning 

aerate Sistas The rebuild process is in progress for the structure. 

.l.. .... | The rebuild stop process is in progress for the struc- 
ture. 


.-l. .... This event does not pertain to a real connection but 
indicates that all rebuild existing connection events 
have been received. 

w2eX XXXX Zero 


If byte 06 indicates a recommended action, use the following flags: 


Bit Meaning 

Lives, wast The rebuild process is in progress for the structure. 

.1.. .... | The rebuild stop process is in progress for the struc- 
ture. 


..-l. .... Policy is available to determine action. 
.-l .... Action is disconnect. 
. XXxx Zero 


For all other events, use the following flags: 


Bit Meaning 

biat e¢en The rebuild process is in progress for the structure. 

.1.. .... | The rebuild stop process is in progress for the struc- 
ture. 


.-l. .... | VTAM ignored this event. 
»+eX XXXx Zero 


Event identifier (See the mapping of ISTXEEPL in VTAM Data Areas 
for MVS for an explanation of this code.) 
The connection identifier for the target of this event 
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CFEE 


08-0B 
OC-—OF 


10 
11 


12 
13 


14-17 


18-1B 


1C-1F 
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Connection control block (ISTCFCON) address 

Event sequence number. Each event is assigned a unique sequence 
number. 
The connection identifier for the subject of this event 

Connection FSM State. Connection states are listed in the VTAM data 
map ISTCFCON. 

Reason for starting Rebuild (See the mapping of ISTXEEPL in VTAM 
Data Areas for MVS for an explanation of this code.) 

Reason for stopping Rebuild (See the mapping of ISTXEEPL in VTAM 
Data Areas for MVS for an explanation of this code.) 

User Data 1 


The contents of this field depend upon the event received and the state 
of the structure when the event was received. 


If this event pertains to a user sync point, this field contains the 
connector-defined event for the user sync point set if a user sync point 
has been set. 


If this event pertains to a disconnect or failed connection event, then 
this field will contain the first 4 bytes of the connector-defined data 
specified in IXLDISC. 


If this event pertains to a rebuild event, then this field will contain the 
connector-defined reason for starting rebuild, if a connector-specified 
reason was given. 


Otherwise, this field will contain all zeros. 
User Data 2 


The contents of this field depend upon the event received and the state 
of the structure when the event was received. 


If this event pertains to a user sync point, this field contains the 
connector-defined event for the user sync point confirmed if a user 
sync point has been confirmed. 


If this event pertains to a disconnect or failed connection event, then 
this field will contain the last 4 bytes of the connector-defined data 
specified in IXLDISC. 


If this event pertains to a rebuild stop event, then this field will contain 
the connector-defined reason for stopping the rebuild, if a 
connector-specified reason was given. 


Otherwise, this field will contain all zeros. 
Request parameter header (RPH) Address. 
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CFER Entry for Coupling Facility Connection Event Exit Response 
Service 


Entry: CFER 
VIT Option: CFS 
Event: Invocation of the MVS macro IXLEERSP 


VIT Processing Module: ISTRACCF 
Control is Returned to: ISTFSURS 
Applies to: MVS 


This trace record is written when a response is given to an event exit event using 
the IXLEERSP macro. 


0/0/0/0/0/O/O/0;0/0/O/0;0;/O/O/O; 1) 1) 2) 1) 171) 1) 11); 1) 1) 2) 1j.)1 
0}1)2)3)4/5)6)7)8/9/A;BiC/DIE} FIO) 1)/2)3)4)/5)6)7/8)9)A|BIC|D/E|F 


CFER S;}E;C}CFCON {EVENT j|RETURN |RETURN |}REASON | RPH 
V|0| ADDRESS | SEQ ADDRESS | CODE CODE ADDRESS 
E NUMBER 
N 
T 
I 
D 


Byte (hex) Contents 
00—03 Record ID: C'CFER' 


AQOmMmMawWwc 
AOmMaza=a 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
05 The connection identifier of the subject of the original event. This field 


applies to Disconnected/Failed Events, Existing Connection Events, 
and Rebuild Connect Failure Events only. 


06 Event code (See the mapping of ISTXEEPL in VTAM Data Areas for 
MVS for an explanation of this code.) 

07 Connection identifier of the invoker of IXLEERSP 

08—OB Connection control block (ISTCFCON) address 

OC—OF The event sequence number of the event to which a response is being 


given. This field applies to Disconnected/Failed Events, Existing Con- 
nection Events, and Rebuild Connect Failure Events only. Otherwise, 
this field contains a zero. 

10-13 The address of the invoker of IXLEERSP 

14-17 Return code for the MVS macro IXLEERSP 

18-1B Reason code for the MVS macro IXLEERSP 

1C-—1F Request parameter header (RPH) Address. 
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CFFC Entry for Coupling Facility IXLFORCE Service 


Entry: 


VIT Option: 


Event: 


CFFC 
CFS 
Invocation of the MVS macro Ee 


VIT Processing Module: ISTRACCF 
Control is Returned to: ISTFSUFC 


Applies to: 


This trace record is written when a failed-persistent connection is deleted using the 


IXLFORCE macro. 


Byte (hex) 


00-03 
04 


05 
06 


07 
08-0B 
OC-OF 
10-13 
14-17 
18-1B 
1C-1F 
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HHH 4HBE SHAE slzlala APE 
al Hb lPlala HAE HAP AHR 


AOmMzAz Oo 


aH . CFCON RETURN |RETURN | REASON | RPH 
0| ADDRESS ADDRESS | CODE CODE ADDRESS 


Contents 

Record ID: C'CFFC' 

ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

The connection identifier of the failed-persistent connection 
The function requested by this invocation of IXLFORCE: 
X'01' REQUEST(CONNECTION) has been specified. 
Connection identifier of the invoker of IXLFORCE 
Connection control block (ISTCFCON) address 

Zero 

The address of the invoker of IXLFORCE 

Return code for the MVS macro IXLFORCE 

Reason code for the MVS macro IXLFORCE 

Request parameter header (RPH) Address. 
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CFLS Entry for Coupling Facility IXLLIST Service (Part 1) 


Entry: CFLS 
VIT Option: CFS 
Event: Invocation of the MVS macro IXLLIST 


VIT Processing Module: ISTRACCF 

Control is Returned to: ISTFSKRT, ISTFSUCL, ISTFSUDL, ISTFSUEN, 
ISTFSUHT, ISTFSUMT, ISTFSURH, ISTFSURL, 
ISTFSUUL, ISTFSUWT 

Applies to: MVS 


This trace record is written for a request to access the coupling facility structure 
using the IXLLIST macro. 


O;O/O/O/O/O;O/O/O/O;O/O;O;O,O;O1) 1) 1) 1; 2) 2) 171) 1)1)1)1)1;1f1)1 
0} 1)2/3)4)5/6)7/8/9)A|BICIDIE|F/O/1)2)3/4/5/6)7/8/9,A|BiCiDIE/F 


CFLS T}E/F/C|CFCON |M)D/L|L]RETURN | RETURN |REASON | RPH 
D}V|U|0} ADDRESS |}0|A| 0/0} ADDRESS | CODE ADDRESS 
DI T/C 
E}A|K 
0)0 
P|P 
EVE 
RIR 


Byte (hex) Contents 

00—03 Record ID: C'CFLS' 

04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05 Event flags: 

Bit Meaning 
Lia's Atarax Request will complete asynchronously. 
~XXX XXXX Zero 

06 The function requested by this invocation of IXLLIST: 
X'01' REQUEST(READ) specified 
X'02' REQUEST(READ_LCONTROLS) specified 
X'03' REQUEST(WRITE) specified 
X'04' REQUEST(MOVE) specified 
X'05! REQUEST(DELETE) specified 
X'06' REQUEST(LOCK) specified 

07 Connection identifier of the invoker of IXLREBLD 

08—OB Connection control block (ISTCFCON) address 

oC The value specified for the MODE parameter: 

X'01! MODE(SYNCSUSPEND) 
X'02' MODE(SYNCEXIT) 

OD The value specified for the DATAOPER parameter, or zero. This field 
applies to the MOVE and DELETE functions only. Otherwise it is set 
to zero. 

X'01' DATAOPER(NONE) specified or assumed by default 
X'02' DATAOPER(READ) specified 


—+ 2m 
Ooze 
AOmMwz=z 
rTzZONKO 


AND > remy 
ore 
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CFLS 


OE 
OF 


10-13 
14-17 


18-1B 


1C-1F 
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X'03' _ DATAOPER(WRITE) specified 

The value specified for the LOCKOPER parameter or zero 
X'01!' LOCKOPER(SET) specified 

X'02' LOCKOPER(RESET) specified 


The value specified for the LOCKCOMP parameter or zero. This one 
byte value represents the connection identifier of the connector that is 
assumed to own a given lock. 

The address of the invoker of IXLLIST 

Return code for the MVS macro IXLLIST or the first four bytes of 
request data. If this IXLLIST invocation will complete asynchronously, 
this field holds the first four bytes of the request data specified for this 
request. Otherwise, it holds the return code for this invocation of 
IXLLIST. 

Reason code for the MVS macro IXLLIST or second four bytes of 
request data. If this IXLLIST invocation will complete asynchronously, 
this field holds the first four bytes of the request data specified for this 
request. Otherwise, it holds the reason code for this invocation of 
IXLLIST. 

Request parameter header (RPH) Address. 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” CFL2 
Licensed Materials — Property of IBM 


CFL2 Entry for Coupling Facility IXLLIST Service (Part 2) 


Entry: CFL2 

VIT Option: CFS 

Event: Invocation of the MVS macro IXLLIST 
VIT Processing Module: ISTRACCF 

Applies to: MVS 


This trace record is a continuation of the CFLS entry. 


O/O/O/O/O;O/O;O;O;O;O;O;O;O;O;O; 1; Lj LjiLjiLyLpljplpi;lplyiiiayljii1 
0)1)2/3/4/5]6,;7;) 8/9; A; BiC}DIE]F/0}1);2)3)4)5}6)7)8)9/A)ByC)DJE] F 


CFL2 SOURCE ENTRYNAME, ENTRYID, OR 
LIST ENTRYKEY 
NUMBER 


Byte (hex) Contents 

00—03 Record ID: C'CFL2' 

04-07 The list number, if any, from which data is being retrieved. This field 
applies to move and read requests; it represents the list on which the 
data being manipulated originates. 

08—OB Zero 

OC—OF The index of the lock, if any, that is being manipulated 

10-1F The value of any ENTRYNAME, ENTRYID, or ENTRYKEY parameter 
specified. 
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CFNEF Entry for Coupling Facility Event Notification 


CFNF STRUCTURE RPH 
| NAME 


‘Entry: CFNF 

VIT Option: CFS 

Event: _ Event Notification Facility (ENF) Exit Driven for Event 
X'35' 

VIT Processing Module: ISTRACCF 

Control is Returned to: ASTFSXEF 

Applies to: MVS 


This trace record is written when a change in coupling facility resources or in the 


coupling facility structure has occurred that may now allow a connection to a struc- 
ture that had previously failed. 


lle {Hib vlalela 
HEE ABBE 


Byte (hex) Contents 
00—03 Record ID: C'CFNF' 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05 Zero 

06 Exit function codes pertaining to ENF Events with event code X'35': 
X'01' A coupling facility resource has become available that may 

allow a structure to successfully connect. 

X'02' A specific coupling facility structure has become available. 

07—0B Zero 

0C-1B lf the exit function code is X'02', this will contain the structure name. 


Otherwise, it will contain zeros. 
1C-1F Request parameter header (RPH) Address. 
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CFRB Entry for Coupling Facility Structure Rebuild Service 


Entry: CFRB 

VIT Option: CFS 

Event: Invocation of the MVS macro IXLREBLD 
VIT Processing Module: ISTRACCF 

Control is Returned to: ISTFSURB 

Applies to: 


This trace record is written when a rebuild of the coupling facility structure is 
started, stopped, or completed, using the IXLREBLD macro. 


O/O;/O/O/O/O/O;O/O;/O;O/O;O;O;O;O; LiL) A;LpLpLpaylpLplpaylyapayaf7 
0} 1)2}3)4/5/6)7/8)/9;A|BIC}DIE} F/O} 1)2)3)4/5)6) 7/8) 9;A/BiCi|DIE|F 


CFRB I|}F}F/C} CFCON | CONNECT | INVOKER| MVS RPH 
D}L{U}O; ADDRESS |REASON | ADDRESS|RETURN |REASON | ADDRESS 
N 
C 
qT 
I 
0 
N | 


Byte (hex) Contents 
00-03 Record ID: C'CFRB' 


AOmMazZa 


| a TE | 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
05 Macro Parameter Flags 
Bit Meaning 
Tides Ohres STARTREASON(LOSSCONN) was specified for the 
request. 
-l.. .... STARTREASON(STRFAILURE) was specified for the 
request. 
..l. .... SGTOPREASON(LOSSCONNOLD) was specified for the 
request. 
..1 .... STOPREASON(LOSSCONNEW) was specified for the 
request. 
... 1... The rebuild was started or stopped for a connection- 


specific reason. Bytes X'0C'—X'OF' contain the 
connection-specific reason. 


eee EXRX: -ZETO 
06 The function requested by this invocation of IXLREBLD: 
X'01! REQUEST(START) was specified. 
X'02' REQUEST(STOP) was specified. 
X'03' REQUEST(COMPLETE) was specified. 
07 Connection identifier of the invoker of IXLREBLD 
08—OB Connection control block (ISTCFCON) address 
OC—OF Connection-specific reason for starting or stopping the rebuild. 


10-13 The address of the invoker of IXREBLD 
14—17 Return code for the MVS macro IXLREBLD 
18-1B Reason code for the MVS macro IXLREBLD 
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1C-—1F Request parameter header (RPH) Address. 
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CFUS Entry for Coupling Facility User Sync Point Service 


Entry: CFUS 
VIT Option: CFS 
Event: Invocation of the MVS macro IXLUSYNC 


VIT Processing Module: ISTRACCF 
Control is Returned to: ISTFSUUS 
Applies to: MVS 


This trace record is written when a connector sets or confirms a user sync point for 
a coupling facility structure with the IXLUSYNC macro. 


O}O;/O/O/O/O;O/O/O/O/O/O;O;O;O;O}; 1) 1)L)LiA;Ap1pli]Lp1jp1jiyapiy1y1 
0/1)2)3/4/516)7/8/9/AIBIC|DJE}F/O/1/2)3/4)5;6;7;8/9) A; By Cj DIE] F 


CFUS T}O}F/C|CFCON {USER RETURN |RETURN {REASON |RPH 
D} |U}O;ADDRESS|EVENT |ADDRESS| CODE CODE ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C'CFUS' 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
05 Zero 
06 Function requested by this invocation of IXLUSYNC: 
X'01! SET function requested 
X'02' CONFIRM function requested 
X'03' CONFIRMSET function requested 
07 Connection identifier of the invoker of IXLUSYNC 


08—O0B Connection control block (ISTCFCON) address 

OC—OF The value of USEREVENT parameter for this invocation of IXLUSYNC 
10-13 The address of the invoker of IXLUSYNC 

14-17 Return code for the MVS macro IXLUSYNC 

18-1B Reason code for the MVS macro IXLUSYNC 

1C-1F Request parameter header (RPH) Address. 
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Cl1 or CO1 Trace Entries 


This trace record provides information about the inbound and outbound requests 
sent to session services to begin or end a same-network or cross-network LU-LU 
session. 


The Cl1 and CO1 traces have two formats: 


e Format 0 is used for same-network sessions or when VTAM does not know 
whether the request is for a cross-network session. This format contains parts 
1, 2, and 3 of the Cin or COn record. 


¢ Format 1 is used for cross-network sessions. This format contains parts 1, 2, 
3, and 4 of the Cin or COn record. 
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Cli or CO1 Entry for SSCP (RUPE--Part 1) 


Entry: Cli1 or CO1 
VIT Option: SSCP 
Event: Requests (Part 1) 


VIT Processing Module: ISTRACSC 
Control is Returned to: Module that issued the INTRACE macro 


Applies to: 


Part 1 of the Cln or COn record is for both format 0 and format 1 and contains 
essentially the same information as the CCI or CCO entry. 


If this entry is associated with an event failure (that is, the sense data is non-zero), 
this entry is generated whether the SSCP option is in effect or not. It is treated as 
an exception condition and, therefore, is traced whenever the VIT is active. 


eae 4H IHRE lal test 
HEE HH ae peal al5lals “He 


Cll |F TIC SAVE |RETURN ORIGIN DESTINATION 
ADDRESS| NETWORK {NETWORK 
ADDRESS |ADDRESS 


Byte (hex) Contents 
00-02 Record ID: 
e C'Cl1' for inbound processing 
e C'CO1' for outbound processing 


03 Flags 
Bit Meaning 
Oise ‘vee Requests 
tes: tare Response 
.0.. .... Nosense 
Wie wawk- —SOnSse 
rere 00 Format oO 
eae 01 Format 1 

04 ID is one of the following: 


e Primary address space ID 

This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID 
e Task ID 


05 Control block ID=X'54' 

06-07 Initiation and termination finite state machines (taken from the session 
information block, SIB) 

08—O0B Save area address 


OC-—OF Save area ID (bytes 4, 5, 7, and 8 of the module name if available) 
10-13 Address of the issuer of the macro (CPCALL, CPEXIT, or CPWAIT) 
14-19 Network address at origin (RUPEOAF) 

1A-—1F Network address at destination (RUPEDAF). 
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Cl1 or CO1 Entry for SSCP (NCSPL--Part 1) 


Entry: Cli or CO1 
VIT Option: SSCP 
Event: Requests (Part 1) 


VIT Processing Module: ISTRACSC 
Control is Returned to: Module that issued the INTRACE macro 


Applies to: 


alee 4HHE rlPlals SEE slatale HE 
HH BE Plats HAE 9/A\B 


C11 RETURN | CPCB DESTINATION 
ADDRESS, OPCODE NETWORK 
ADDRESS 


Byte (hex) Contents 
00-02 Record ID: 
e C'Cl1' for inbound processing 
e C'CO1' for outbound processing 


03 Flags 
Bit Meaning 
Oia: eos Requests 
Msgee: tates Response 


OS. “éaces No sense 
.l.. .... Sense 


ee 00 Format 0 
abies tae 01 Format 1 
04 ID is one of the following: 


¢ Primary address space ID 

This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID 
° Task ID 


05 Control block ID=X'60' 
06 _ Flags (CPCBFL) 
07 CPCB return code (CPCBRC) 


08—OB Save area address 

OC—OF Save area ID (bytes 4, 5, 7, and 8 of the module name if available) 

10—13 Address of the issuer of the macro (CPCALL, CPEXIT, or CPWAIT) 

14-17 CPCB operation code (see Appendix G, “Control Point/Control Block 
(CPCB) Operation Codes” on page 1127) 

18 WTD type 

19 Zero 

1A-1F Network address at destination (NCSPLDAF). 
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Cl1 or CO1 Entry for SSCP (not RUPE or NCSPL--Part 1) 


Entry: Ci1 or CO1 
VIT Option: SSCP 
Event: Requests (Part 1) 


VIT Processing Module: ISTRACSC 
Control is Returned to: Module that issued the INTRACE macro 


Applies to: 


HH He 4HBb oe JAE ABE 
{He 4H al3lals aHAE AHBE 


C11 le C}R| SAVE SAVE |RETURN | CPCB CPCB CPCB 
T| AREA ADDRESS|OPCODE |WORD 3 |WORD 4 
| ADDRESS 


Byte (hex) Contents 
00-02 Record ID: 
e C'Cl1' for inbound processing 
¢ C'CO1' for outbound processing 


on w 
1 OO 


03 Flags 
Bit Meaning 
Omid. ates Requests 
Week case: Response 
.0.. .... Nosense 
.l.. .... Sense 
awa oe 00 Format 0 
eae, ah 01 Format 1 

04 ID is one of the following: 


e Primary address space ID 

This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 


05 Control block ID (see Appendix H, “Storage and Control Block ID 
Codes” on page 1137) 

06 CPCB flag (CPCBFL) 

07 Return code (CPCBRC) 

08—0B Save area address 


OC—OF Save area ID (bytes 4, 5, 7, and 8 of the module name if available) 

10-13 Address of the issuer of the macro (CPCALL, CPEXIT, or CPWAIT) 

14-17 CPCB operation code (see Appendix G, “Control Point/Control Block 
(CPCB) Operation Codes” on page 1127) 

18-1B CPCB word 3 (field WIDPTR) 

1C—1F CPCB word 4 (field CPCBPH). 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Appendix A. VTAM Internal Trace (VIT) Record Descriptions 627 


Ci2 or CO2 “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Ci2 or CO2 Entry for SSCP (RUPE--Part 2) 


Entry: | Cl2 or CO2 

VIT Option: SSCP 

Event: Requests (Part 2) 
VIT Processing Module: ISTRACSC 
Applies to: 


The Cl2 and CO2 trace records are continuations of the Cl1 and CO1 entries. 
OOOO O;O/O;O;O;O;O;O;O;O;O)O) 1) 1) 1)1)1)1)1)1)1)1)14)1)1)1)1)1)] 
0}1)2)3}4)5]6|7|8|9;A|BiC|D]E}F/0/1)2)3]4)5|6}7|8|9/A;BiC|DI EF 


C12 Ic ~ FIRST 24 BYTES OF RU SENSE 
OR |B | 
co2 |I | 

D 


Byte (hex) Contents 
00-02 Record ID: 
¢ C'Cl2' for inbound processing 
e C'CO2' for outbound processing 


03 Control block ID=X'54' 
04—1B First 24 bytes of RU 
1C-1F Sense data or zero. 
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Ci2 or CO2 Entry for SSCP (NCSPL--Part 2) 


Entry: Cl2 or CO2 

VIT Option: SSCP 

Event: Requests (Part 2) 
VIT Processing Module: ISTRACSC 
Applies to: 


This trace record is a continuation of the Cl1 or CO1 trace record. 
OOLO OOOO O/O/O/O/O/O/O;OlO;LILILILILILILILILi1i1iizsi1sy1s141 
OILIZ/Z/4/5IGI7ZIS/IIAIBICID/E/FIO}1/2/3/4/5/6)7/8/9/AIBICIDIE|F 


C12 |C} RDTE CPCB 
B} STATE | WTD 
I 
D 


Byte (hex) Contents 
00-02 Record ID: 
e C'Cl2' for inbound processing 
e C'CO2' for outbound processing 
03 Control block ID=X'60' 
04—07 RDTE state (in control block RPRE). This value, a resource status 
code, is explained in “Resource Status Codes and Modifiers” in VTAM 
Messages and Codes and in control block FSM. See VTAM Data 
Areas for MVS/ESA, VTAM Data Areas for VM/ESA, or VTAM Data 
_ Areas for VSE/ESA. | , 
08—OB CPCB WTD (first four bytes) 
O0C—1F Zero. 
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Ci2 or CO2 Entry for SSCP (not RUPE or NCSPL--Part 2) 


Entry: Ci2 or CO2 

VIT Option: SSCP 

Event: Requests (Part 2) 
VIT Processing Module: ISTRACSC 
Applies to: 


This trace record is a continuation of the Cl1 or CO1 trace record. 


O/O;O/OH/O;O/O/O/O/O;O;O/O/ LIDIA; LILi Tis ApLidyayisazsyayail 
3}4/5/6}7)8)9;A|BjC|D)E| FiO) 1,2) 3)4)/5)6)}7)8)9;A|B)C}D)E|F 
C 


On w 


Byte (hex) Contents 
00—02 Record ID: 
¢ C'Cl2' for inbound processing 
e C'CO2' for outbound processing 
03 Control block ID (see Appendix H, “Storage and Control Block ID 
Codes” on page 1137) 
04—1F Zero. 
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CI3 or CO3 Entry for SSCP (RUPE, NCSPL, or Not RUPE or 


NCSPL--Part 3) 
Entry: Cl3 or CO3 
VIT Option: SSCP 
Event: Requests (Part 3) 
VIT Processing Module: ISTRACSC 
Applies to: 


Part 3 of the Cln or COn record is for both format 0 and format 1 and contains the 
address of the ISTSIB for the session, the ISTPCID, and the PLU and SLU names. 


Note: If this is the last Cln or COn entry, these are the PLU and SLU names as 
known in this network. If this entry is followed by Cl4 or CO4, these are just the 
PLU and SLU names. The Cl4 or CO4 entry identifies the network. 


O/O/O/O/O/O/O/O;O/O/O;O;O;O;O;O; A A;A;T;PLPA;ApLpLiA;A;A;Ap aj iy 
Q)1)21/3/4/5)6)7/8/9/A)Bi CDE} F/O) 1) 2)3)4)5)6)71/8)9; A; Bi Ci DIE] F 
CI3 SIB PCID FOR THIS PLU NAME SLU NAME 
OR ADDRESS REQUEST 

C03 


Byte (hex) Contents 
00-02 Record ID: 
e C'CI3' for inbound processing 
¢ C'CO3' for outbound processing 
03 Zero 
04—07 SIB address 
O8—OF PCID for this request 
10-17 PLU name 
18-—1F SLU name. 
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Cl4 or CO4 Entry for SSCP (RUPE, NCSPL, or Not RUPE or 


NCSPL--Part 4) 
Entry: 7 Ci4 or CO4 
VIT Option: SSCP 
Event: Requests (Part 4) 
VIT Processing Module: ISTRACSC 
Applies to: 


Part 4 of the Clin or COn entry is for format 1 only. 
0/0/0/0)0/0/0/0/0/0/0)0/0/0)0/0) 1) 1) 1) 1) 2) 171) 1)1)1)1]1)1)14;1)1 
0/1)2/3|4)5|6)7/8/9/A|BiC/D/E]F)0}1)2)3)4)5|6)7/8/9{/A|BiCiDIE;F 
C14 PCID IN PLU NETID SLU NETID 
OR PREVIOUS 

C04 REQUEST 


Byte (hex) Contents 
00-02 Record ID: 
e C'CI4' for inbound processing 
e C'CQO4' for outbound processing 
03-07 Zero 
08—OF PCID in previous request 
10-17 PLU network ID 
18—1F SLU network ID. 
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CNA Entry for VCNSCMD Issued by Application 


Entry: CNA 
VIT Option: VCNS 
Event: VCNSCMD issued by application 


VIT Processing Module: ISTRACNS 
Control is Returned to: ISTAICVC 


This CNA trace record shows VCNS command requests. The API routine 
ISTAICVC writes the entry and then queues the RPL to the correct PAB. 


0/0/0/0)0)0)0/0/0/0/0/0)0/0;O)O) 1) 1) 1) 1) 272) 2) 17272) 2) 1) 1) 2)141 
0}1)2)3)4/5/6)7/ 8/9) A|B/C)DJE] F/O) 1) 2)/3)4)5)6)7)8)/9)A|BIC|DIE|F 


CNA E;O;C}RPL RPL3 RPL VCNS OPERAND- 
X|P)N|ADDRESS|ADDRESS| AREA | FLAGS DEPENDENT 
TIT DATA 
D}1 
S 


Byte (hex) Contents 
00-03 Record ID: C'CNA' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 


—- aaa 


05 Exit definition (RPLEXTDS) 
Bit Meaning 
Liaa: whee Indicates RPL exit was scheduled 
.1.. .... Indicates RPL exit not specified 
..l. .... Indicates RPL exit was specified 
~eX XX.. Zero 
..l. Indicates BRANCH=YES specified 
a x Zero 
06 Option code byte 1 (RPLOPT1) 
Bit Meaning 
XXXX .... Zefo 
. 1... | Asynchronous request indicator 
wees oXX. ZEFO 
sbieidiodues 1 External ECB indicator 
07 VCNSCMD CONTROL= operand value 
08 INQUIRE 
10 LOGON 
14 TEST 
18 XID 
20 LOGOFF 
30 READ 
40 STATUS 
50 SET 
60 OPEN 
70 CLOSE 
80 SEND 
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CNA 


08—0B 
OC-—OF 
10-13 


14 


1C-1F 
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90 SUSPEND 
AO RESUME 
BO EXPEDITE 
Co CHECK 

DO RESET 
EO SETCPARM 
FO RECEIVE 

FC REPLY 

RPL address 


RPL3 address (RPLAAREA) 

Address of area into which data is to be read or from which data is to 
be written (RPLAREA), or zero if no area is supplied 

VCNS flag byte 


Bit Meaning 
bees: Bias Q-bit indicator 
1... .... M-bit indicator 
.-l. .... D-bit indicator 

.-l1 .... Buffer list indicator 
wees XXXX ZeFro 
VCNS flag byte 
Bit Meaning 
OG 8s se Continue specific 
Olt: ween Continue any 
Tigies dies Continue same 
..00 .... Data flow=on 
..01 .... Data flow=off 
.-l1 .... Data flow=same 

. 1... Receive any indicator 

wees XXX ZeLro 
VCNS flag byte 
Bit Meaning 


STYPE=CONFIRM indicator 
~XXX XXXX Zero 
Zero 
When CONTROL = LOGON or CONTROL = INQUIRE: symbolic name 
of the network access point 
When CONTROL does not equal LOGON and CONTROL does not 
equal INQUIRE and the request is an X.25 request: address into 
which expedited data is to be read or from which expedited data is to 
be written, or zero if no area is supplied 
When CONTROL does not equal LOGON and CONTROL does not 
equal INQUIRE: connection or resource identifiers (RID) 
e RID is supplied when the VCNSCMD CONTROL value is: 

LOGOFF 

OPEN (STYPE=REQUEST) 

READ 

RECEIVE (when SMODE is CONNECTIONLESS) 

REPLY 

SEND (when the connection ID value is zero) 

SET 

SETCPARM (when the connection ID value is zero) 

STATUS (when the RID value is not zero) 

TEST 
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XID 
e Connection identifier is supplied when the VCNSCMD CONTROL 
value is: 
CLOSE 
EXPEDITE 
OPEN (STYPE=CONFIRM) 
RECEIVE (Specific) 
RESET 
RESUME 
SEND (when the connection ID value is not zero) 
SETCPARM (when the connection ID value is not zero) 
SUSPEND 
STATUS (when the RID value is zero). 
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CNP1 or CNR1 Entry for ECB Posted or RPL Exit Dispatched (Part 1) 


Entry: 

VIT Option: 

Event: 

VIT Processing Module: 
Control is Returned to: 


-CNP1 or CNR1 

VCNS 

ECB posted or RPL exit dispatched (Part 1) 
ISTRACNS 

ISTAICPT for CNP1 

ISTAPCUE for CNR1 


The CNP? trace record is written when an ECB is posted. The CNR1 trace record 
is written when an RPL exit is dispatched. These trace records signal that exe- 
cution of the VCNSCMD macroinstruction is complete and show the data returned 
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jolalojojojejojojojo/ojejojojojoj1j1f1fajajaj2ja}ajafajafajafasi 
0} 1)/2/3)4)5/6)7; 8/9) A|BIC|DIE}FiO}1)2)3)/4)5)6)7)/8)9/A|B/C)D\E|F 


to the user application program. 


—- wa 


CNP1 R}F/C}RPL RPL3 RPL VCNS PARAMETER- 
T|D)N}ADDRESS|ADDRESS} AREA | FLAGS DEPENDENT 
NiB DATA 
Ci2 
DI 


Byte (hex) Contents 
00-03 Record ID: 
e C'CNP1' for ECB posting 
e C'CNR1' for RPL exit dispatching 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 


05 Global VTAM return code (RPLRTNCD) 
06 Global VTAM feedback code (RPLFDB2) 
07 VCNSCMD CONTROL= operand value 

08 INQUIRE 

10 LOGON 

14 TEST 

18 XID 

20 LOGOFF 

30 READ 

40 STATUS 

50 SET 

60 OPEN 

70 CLOSE 

80 SEND 

90 SUSPEND 

AO RESUME 

BO EXPEDITE 

Co CHECK 

DO RESET 

EO SETCPARM 


FO RECEIVE 
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08—0B RPL address 
OC—OF RPL3 address (RPLAAREA) 


10-13 Address of area containing user data (RPLAREA), or zero if no area is 
supplied 
14 VCNS flag byte 
Bit Meaning 
lias ess Q-bit indicator 
.l.. .... M-bit indicator 
..l. ....  D-bit indicator 
..l .... Buffer list indicator 
we. XXXX Zefo 
15 VCNS flag byte 
Bit Meaning 
OG is. wie Continue specific 
Olid. cuswe Continue any 
antag Continue same 


..00 .... Data flow=on 
..01 .... Data flow=off 
..11 .... Data flow=same 
.. 1... Receive any indicator 
weee eXXX ZELO 
16 VCNS flag byte 
Bit Meaning 
Leia eset STYPE=CONFIRM indicator 
.XXX XXXX Zero 
17 Zero 
18-1B Address into which expedited data is to be read or from which expe- 
dited data is to be written, or zero if no area is supplied 
1C-—1F Connection or resource identifier (RID) 
e RID is returned when the VCNSCMD CONTROL value is: 
LOGON 
LOGOFF 
READ 
SET 
STATUS (for network access point) 
TEST | 
XID 
e Connection ID is returned when the VCNSCMD CONTROL value 
is: 
CLOSE 
EXPEDITE 
OPEN 
RECEIVE 
RESET 
RESUME 
SEND 
SETCPARM 
SUSPEND 
STATUS (for connection) 
e Zero is returned when the VCNSCMD CONTROL value is 
INQUIRE. 
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CNP2 or CNR2 Entry for ECB Posted or RPL Exit Dispatched (Part 2) 


Entry: CNP2 or CNR2 

VIT Option: VCNS 

Event: ECB posted or RPL exit dispatched (Part 2) 
VIT Processing Module: ISTRACNS 

Applies to: 


The CNP2 trace record is a continuation of the CNP1 trace record. The CNR2 
trace record is a continuation of the CNR1 trace record. 


sp 4HHP 4H JHHBHE BER 
HHH 4HHE HEE HAE ABE AR Ee 


CNP2 SENSE | EXPEDITED DATA 


Byte (hex) Contents 
00-03 Record ID: 
e C'CNP2' for continuation of CNP1 
e C'CNR2' for continuation of CNR1 
04-07 ECB or RPL exit address (RPLECB) 
08—09 VCNSCMD primary return code 
OA-—0B VCNSCMD secondary return code 
OC—OF Length of area containing user data (RPLRLEN) 


10—11 Length of expedited data area 
12-13 Length of expedited data received 
14-17 Four bytes of sense data, or zero when no sense data is returned 


18—1F Eight bytes of expedited data. 
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CNP3 or CNR3 Entry for ECB Posted or RPL Exit Dispatched (Part 3) 


Entry: CNP3 or CNR3 

VIT Option: VCNS 

Event: ECB posted or RPL exit dispatched (Part 3) 
VIT Processing Module: ISTRACNS 

Applies to: 


The CNP3 trace record is a continuation of the CNP2 trace record. The CNR3 
trace record is a continuation of the CNR2 trace record. These records are written 
only when the VCNSCMD CONTROL operand value is RECEIVE or CLOSE, and 
RPLRLEN is greater than zero. 


OOO; OO; O;O;O;O;O;O; LiL; ApApLpLpApLpLiap_ylyay lj ipl 
516/7/8{/9;A|Bi/C}D{E; FiO) 1)2)3]}4)5/6}7)|8/9}A} B/C) DIE} F 


DATA FIELD 


0/0 
1;2;3)4 


Byte (hex) Contents 
00-03 Record ID: | 
e C'CNPS3' for continuation of CNP2 
| ¢ C'CNR3' for continuation of CNR2 
04—1F Twenty-eight bytes of user data (RPLAREA). 
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CONN Entry for SHM Connect 


Entry: CONN 
VIT Option: ClO 
Event: Connection 


VIT Processing Module: ISTRACCI 
Control is Returned to: ISTTSCiIR 


Applies to: 


This trace record is generated for X.21 short-hold mode attachments. It is written 
when a port is connected to a station. 


O/O/O/O/O;O/O/O/O/O;O;O;O;O;O;O; LT LiL Ap L{Dpdpdylplpdjljijiyayl 
0} 1)2)/3)4)5/6)/7/8)9/A|BIC}DIE|F/O}1)2)3)4)5)6)7)/8/9/A,B)C| DIE F 


CONN |T/C}P;}S}; CUA |GROUP |HALCB | PUT 
I H NCB ADDRESS | ADDRESS 
K S ADDRESS 
I 


Byte (hex) Contents 
00—03 Record ID: C'CONN' 


04 Task identification key 

05 Connection finite state machine (FSM; see HALCFSM in ISTHALCB for 
values) 

06 Port manager FSM (see HALPMFSM in ISTHALCB for values) 

07 X.21 short-hold mode status indicator (see PUTFLG1 in ISTPUT) 


08—OB Channel unit address of link | 
OC-—OF Group network control block address (ISTGRPCB) 
10-13 Link network control block address (ISTHALCB) 
14-17 Physical unit table address (ISTPUT 


18-1B Zero . 
1C-1D PU element address 
1E—-1F Zero. 
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CPPG or CPPT Entry for CPPURGE or CPPOST Event (Part 1) 


Entry: CPPG or CPPT 
VIT Option: SSCP 
Event: CPPURGE or CPPOST Macro (Part 1) 


VIT Processing Module: ISTRACSC 
Control is Returned to: ISTPVCWP 


Applies to: 


This trace record gives information about CPPURGE or CPPOST macroinstruction 
processing. It may help you determine why I/O is outstanding or why an SSCP 
request is failing. 


CPPG and CPPT are the complements of CPWT. Each CPPT is preceded by a 
CPWT. But a CPPG can post several events at once, as it may be concluding 
several CPWT entries. 


O/O/O/O/O/O/O/O;O/O;O;O;O;O;O;O; 1) 1; 1p1jPLjLpljPLpAjApyljljpaAj1j1qy1 
0) 1)/2)3)4/5)6)7|/8/9)ABiC}DIE| F/O) 1)2)3)4)5)/6/7)8)9|A/B/ Ci DI E|F 


CPPG SENSE 


Byte (hex) Contents 
00-03 Record ID: 
e C'CPPG' for CPPURGE processing 
e C'CPPT' for CPPOST processing 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 


05 Return code set by CPPOST or CPPURGE 
06 Type flags : | 

Bit Meaning 

aNCuinr sews x 1=PVI event 


..X.  1= search on EID 
0 = search on URC 

.X.. For OPTIONS(POST) only, 1 indicates that return of a 
contro! block is optional. This bit corresponds to the 
CTLBLKOP keyword on the CPPOST macro. 

. X... For OPTIONS(FIND) only, 1 indicates that the invoker 

intends to change the WRE's event ID. This bit corre- 
sponds to the CHGEID keyword on the CPPOST macro. 


07 High-order 4 bits: Type of LQAB used for the search 
Value LQAB Type 
0000 Global LQAB 
0001 E|ID-related LQAB 
0010 DAF-related LQAB 
0011 URC-related LQAB 
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CPPG or CPPT 


08-0B 
OC-OF 
10-13 
14-17 
18-1B 


1C-1F 
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Low-order 4 bits: Function requested through the OPTIONS keyword 
on the CPPOST macro, zero for CPPG 


Value Keyword 
0000 FIND 
0001 DEQ 
0010 POST 


LQAB group address 

Data field in ISTWRE 

Work element address 

CPCB operation code that indicates the original request for this work 
element or zero (see Appendix ‘G, “Control Point/Control Block (CPCB) 
Operation Codes” on page 1127) 

For PVI events, caller's save area ID or 0 

For non-PVI events, save area ID | 

For POST or PURGE, sense data or zero 

For DEQ or FIND, zero. 
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CPP2 Entry for CPPURGE or CPPOST (Part 2) 


Entry: CPP2 

VIT Option: SSCP 

Event: CPPURGE or CPPOST macro (Part 2) 
VIT Processing Module: ISTRACSC 

Applies to: 


This trace record contains part or all of the RU for CPPURGE or CPPOST macroin- 
struction processing. It may help you determine why I/O is outstanding or why an 
SSCP request is failing. If an RU is fewer than 24 bytes long, only the bytes in the 
actual RU will be moved to the corresponding fields in the trace records. The left- 
over bytes will be set to zero. 


Note: This trace record is produced only for PVI events where a RUPE is avail- 
able. 


CPP2 j|RETURN FIRST 24 BYTES OF RU OR 0 
ADDRESS 


Byte (hex) Contents 

00—03 Record ID: C'CPP2' 
04—07 Return Address 

O8—1F First 24 bytes of RU or zero. 
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CPP3 Entry for CPPURGE or CPPOST (Part 3) 


Entry: CPP3 

VIT Option: SSCP 

Event: CPPURGE or CPPOST macro (Part 3) 
VIT Processing Module: ISTRACSC 

Applies to: 


0 


This trace record is a continuation of the CPPG or CPPT trace record. 
010 
0 


OOO O/O/O/OO/O/O;O Ol LTiDiiyliasayaytjljpijtiiyl 
1)2)/3/4/5/6)7/ 8/9 A| Bi CIDE; F/O) 1)2)3;4)5)6)7;8;9/AlBIC 
CPP3 25 BYTES OF URC | 


Byte (hex) Contents 

00—03 Record ID: C'CPP3' 
04—1C 25 bytes of URC 
1D-1F Zero. 


0 1)1)1) 
3 DJE|F 
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CPP4 Entry for CPPURGE or CPPOST (Part 4) 


Entry: CPP4 

VIT Option: SSCP 

Event: CPPURGE or CPPOST macro (Part 3) 
VIT Processing Module: ISTRACSC 

Applies to: 


This trace record contains part or all of the event ID (EID) for CPPURGE or 
CPPOST macroinstruction processing. If an EID is fewer than 24 bytes long, only 
the bytes in the actual EID will be moved to the corresponding fields in the trace 
records. The leftover bytes will be set to zero. 


Note: This trace record is produced only when the WRE points to an EID. 


SHEP 
alt Delen 


CPP4 a 


Byte (hex) Contents 

00-03 Record ID: C'CPP4' 
04—06 Zero 

07 Length of EID 

08-—1F First 24 bytes of EID. 


FIRST 24 BYTES OF EID 


2reoem 
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CPRC Entry for CPRC (Part 1) 


Entry: 
VIT Option: 
Event: 


CPRC 
SSCP 
CPRC macro (Part 1) 


VIT Processing Module: ISTRACSC 
Control is Returned to: Module invoking the INTRACE macro that caused the 


Applies to: 


record to be produced. 


This trace record gives information about CPRC macroinstruction processing. It is 
written when a VTAM module issues a CPRC macroinstruction to set a non-zero 
sense code in an RUPE. 


This event is treated as an exception condition and is always traced, whether the 
SSCP option is in effect or not. © 


O/O/O/O/O/O/O;O/O/O;O/O/O/O/O;O;LiLiA;1pLi1j1jp1jlplpljiij;iyijii1 
0) 1)2/3/4)5/6)7/8/9/A;ByC{DJE}F)0}1)2)3/4)5)6)7)8|9/A)B)C|D/E|F 


ORIGIN DESTINATION 


ADDRESS | OPCODE NETWORK |NETWORK 
ADDRESS | ADDRESS 


Byte (hex) 
00-03 
04 


05-07 
08—-OB 
OC-—OF 


10-13 
14-19 
1A-1F 
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Contents 
Record ID: C'CPRC' 
ID is one of the following: 

e Primary address space ID 

This field is zero if the ID is greater than X'FF'. 

e Machine ID and Task ID 

¢ Task ID 
Zero 
Address of RUPE for this macro, or 0 
CPCB operation code for RUPE that indicates the original request for 
this RUPE (see Appendix G, “Control Point/Control Block (CPCB) 
Operation Codes” on page 1127) 
Sense code 
Network address at origin (RUPE) 
Network address at destination (RUPE). 
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CPR2 Entry for CPRC (Part 2) 


Entry: CPR2 

VIT Option: SSCP 

Event: CPRC macro (Part 2) 
VIT Processing Module: ISTRACSC 

Applies to: 


This trace record is a continuation of the CPRC entry. 


O/O/O/O;O;O/O;O;O;O;O/O;O/ OOO; Li LiLiLpdpLylpPTpdydyapdydyayay. 
0} 1)2(3)4)5/6)7;/8/9{A/B{C/DiE}F{0}1)2)3)4)/5])6) 7) 8) 9) ABC} DIE] F 


CPR2 |RETURN | ISSUER |I|R 
ADDRESS| NAME 


Byte (hex) Contents 

00-03 Record ID: C'CPR2' 

04—07 Address of the issuer of the CPRC macro 

08—0C Module name field from the register save area for the 
module that issued the CPRC macro 


This field contains the abbreviated name (bytes 4, 5, 6, 7, 8) of the 
module that issued the CPRC macro. If the issuing module does not 
have its own save area, for example, modules ISTINCF1 and 
ISTPUCTI, this field contains the name field from the save area of the 
caller of the module that issued the CPRC macro. 

OD Instance of the CPRC macro in the issuer 

OE CPCBRC return code 


Note: It is not required that users of the product Know the meaning of 
this internal VTAM return code. When required, the product support 
organization may use it to assist in internal flow diagnosis. 

OF—1F Zero. 


oOo a2zH4 
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CPR3 Entry for CPRC (Part 3) 


Entry: CPR3 

VIT Option: SSCP 

Event: CPRC macro (Part 3) 
VIT Processing Module: ISTRACSC 

Applies to: 


This trace record is a continuation of the CPRC entry. 


JO;O;O/O/O/O/O;/O;O;O;O/O;O;O;O;O; A; TILITiAsAsAsApAPD Aili @yiai1s1 
0)1)2)3)4)5)6)7)8)9)A|BIC)DIE|F}O}1)2)3)4/5)6)7)8) 9; A; By C|D|E|F 


CPR3 25 BYTES OF CPCBURC 


Byte (hex) Contents 

00-03 Record ID: C'CPR3' 

04-1C First 25 bytes of the user request correlator (CPCBURC) entry 
1D-1F Zero. 
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CPTO Entry for CPS Retry 


Entry: CPTO 
VIT Option: ClO 
Event: CPS Retry 


VIT Processing Module: ISTRACCI 
Control is Returned to: ISTTSCVI 
Applies to: 


This trace record is generated for X.21 when a call process signal (CPS) defined in 
the CPS retry table is received from the line and the timer interval defined in the 
CPS retry table for CPS expires. 


ALE HEB ABE “BEE elects 
AHP Plata HHHE ao HHAGBE 


CPTO : C}PIS GROUP |HALCB- | PUT 
H NCB ADDRESS | ADDRESS } 
S ADDRESS M 
I E 


Byte (hex) Contents 
00-03 Record ID: C'CPTO' 


04 Task identification key 

05 Connection finite state machine (FSM; see HALCFSM in ISTHALCB for 
values) 

06 Port manager FSM (see HALPMFSM in ISTHALCEB for values) 

07 X.21 short-hold mode status indicator (see PUTFLG1 in ISTPUT) 


08—OB Channel unit address of link 

O0C—OF Group network control block address (ISTGRPCB) 
10-13 Link network control block address (ISTHALCB) 
14-17 Physical unit table address (ISTPUT) 


18-19 Time interval to wait before retrying the connection 
1A-1B Zero 

1C-1D Retries remaining 

1E-1F CPS number received from the line. 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Appendix A. VTAM Internal Trace (VIT) Record Descriptions 649 


CPWT | | “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


CPWT Entry for CPWAIT Events (Part 1) 


Entry: CPWT 
VIT Option: SSCP 
Event: CPWAIT macro (Part 1) 


VIT Processing Module: ISTRACSC 
Control is Returned to: ISTCPCPW 


Applies to: 


This trace record gives information about CPWAIT macroinstruction processing. It 
may help you determine why I/O is outstanding or why an SSCP request is failing. 


This entry is eventually followed by a CPPT entry (to resume processing) or a 
CPPG entry (to purge the waiting task). Use the EID field to match corresponding 
entries. | 


iHeak HAE Halas ABE rE 
AB “lala Hiab 4HAn al3lals aelals a 


LQAB WREDATA| WORK SENSE 
ADDRESS IN WRE |ELEMENT|OPCODE {AREA ID| CODE 
ADDRESS | IN 


Byte (hex) Contents 
00-03 Record ID: C'CPWT' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
05 Zero 
06 Type flags 
e B'00000001 '=PVI event 
e B'00000000'=non-PVI event 
07 Zero 
08—0B LQAB address for this CPWAIT macro 
OC-—OF Data field in ISTWRE when CPWAIT is performed 
10-13 Work element address | 
14-17 CPCB operation code that indicates the original request for this work 
element or zero (see Appendix G, “Control Point/Control Block (CPCB) 
Operation Codes” on page 1127) 


18-1B For PVI event, caller's save area ID or zero 
For non-PVI event, save area ID 
1C—1F Sense code or zero. 
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CPW2 Entry for CPWAIT (Part 2) 


Entry: CPW2 

VIT Option: SSCP 

Event: CPWAIT macro (Part 2) 
VIT Processing Module: ISTRACSC 

Applies to: 


This trace record is a continuation of the CPWT trace record. If an RU is fewer 
than 24 bytes long, only the bytes in the actual RU will be moved to the corre- 
sponding fields in the trace records. The leftover bytes will be set to zero. 


Note: This trace record is produced only for PVI events where a RUPE is avail- 
able. 


CHRCHACHECHECHACHACHECHECHRCHRCHECHRCHECHRCHECH EGR GU G0 G00 Gna 00 G0 a0 ana ana m7 
0) 1;2)/3/4/5/6)7;/ 8/9) A/BIC|DIE}F/O}1)2)3)4)/5)6)7)8)9)A;ByC}DJE}F 
CPW2 |RETURN FIRST 24 BYTES OF RU 

ADDRESS 


Byte (hex) Contents 

00-03 Record ID: C'CPW2' 
04-07 Return address 
08—1F First 24 bytes of RU. 
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CPW3 Entry for CPWAIT (Part 3) 


Entry: CPW3 

VIT Option: SSCP 

Event: CPWAIT macro (Part 3) 
VIT Processing Module: ISTRACSC 

Applies to: 


This trace record is a continuation of the CPWAIT trace record. 


el il sss eB RP BR 


; CPH3 RUPERC OR ) RUPERC OR 


Byte (hex) Contents 

00-03 Record ID: C'CPW3' 
04-1C RUPEURC or 0 
1D-—1F Zero. 
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CPW4 Entry for CPWAIT (Part 4) 


Entry: CPW4 

VIT Option: SSCP 

Event: CPWAIT macro (Part 4) 
VIT Processing Module: ISTRACSC 

Applies to: 


This trace record is a continuation of the CPW3 trace record. If an event ID (EID) 
is fewer than 24 bytes long, only the bytes in the actual EID will be moved to the 
corresponding fields in the trace records. The leftover bytes will be set to zero. 


Note: This trace record is produced only when the WRE points to an EID event. 


EE 
4H} 


FIRST 24 BYTES OF EID 


Byte (hex) Contents 

00-03 Record ID: C'CPW4' 
04—06 Zero 

07 Length of EID 

08—1F First 24 bytes of EID. 
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CRx Entry for ADD, DELETE, or FIND Control Block 


Entry: CRA, CRD, or CRF 

VIT Option: SSCP 

Event: CRADD, CRDEL, CRFIND 
VIT Processing Module: ISTRACSC 

Applies to: 


The correlate search control block (CR) trace record contains information about a 
control block add, delete, or find operation in the VTAM control point (CP). 


alPlali {als alclolel: 
6|7 ollali Palak valelolele 


CRA MODIFIER, LIST, RETURN PCID CORCB 
SEARCH NUMBER, ADDR or 0 sr 
or 0 


Byte (hex) 
00-02 Record ID: 
C'CRA' (CRADD): Add control block 
C'CRD' (CRDEL): Delete control block 
C'CRF' (CRFIND): Find control block 
03 Type code 
0 Procedure-correlation identifier (PCID) only (6-F contain zeros) 
1 PCID and modifier list (6-F contain the modifier list) 
2 PCID and search number (6-7 contain the search number, 8-F 
contain zeros) 
04 — ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
05 Return code if specified; some FIND calls to this macro do not include 
a return code but use CORCB ADDR as a return code. 


O6—OF 
e If type code = 0, this field is zero. 


e If type code = 1, this field represents the PCID modifier list and is 
padded on the right with zeros. If search number correlation is 
used, this field may be zero. 


e If type code = 2, this field represents the search number and is 
padded on the right with zeros. 


10-13 Calling module's return address 

14-1B —— PCID of the search being correlated 

1C—1F Address of an ISTCORCB; bytes 4-7 of the ISTCORCB contain the 
address of the control block being correlated (LCB, SITCB). This field 
is zero if the entry type is 'CRF' and the control block was not found. 
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Notes: 


1. A CRF entry is usually found soon after a DSP entry for LUSS or DSVC. If the 
CORCB ADDR is zero, the FIND failed. 


2. Search number correlation is only used with DS. 
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DBx Entry for DBDELETE, DBQUERY, and DBUPDATE 


Entry: DBD, DBQ, DBU 

VIT Option: SSCP 

Event: DBDELETE, DBQUERY, DBUPDATE 
VIT Processing Module: ISTRACSC 

Applies to: 


This traces an operation on the APPN directory database. 
4 4h ab nF E AF AF 3 ay 
+f aH HE HE iE Hh 


DBD R} .F RESOURCE - |RETURN | DECB NETID OF 
DBQ C} L | IDENTIFICATION | ADDRESS) ADDRESS RESOURCE 
DBU G 

S 


Byte (hex) Contents 
00—02 Record ID: C'DBD', C'DBQ', C'DBU' 
03 Zero 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
05 Return code (RC) 
06-07 Database information flags 
Bit Meaning 
I pois domed Registered entry-type indicator 
-l.. .... | Cache or dynamic entry-type indicator 
..l. .... Suggestion or defined entry-type indicator 
..l1 .... Reserved for entry-type expansion 
. 1... The VIT error was caused by an error in the cache data 
processing 
-1.. | The VIT error was caused by an error while loading the 
directory from storage 
.-l. The returned network ID on DBQUERY differs from the 
one queried 
ia, shes x Not used 
ee ee Directed failed indicator copied from directory entry 
.l.. .... | Negative cache indicator copied from directory entry 
.-l. .... | Subarea LU indicator copied from directory entry 
..l .... Surrogate owner indicator copied from directory entry 
. 1... | Dynamic subarea destination LU indicator copied from 
directory entry 
.1.. | Wildcard LU indicator copied from directory entry 
.-1. | Non-native LU indicator copied from directory entry 


Kt, D8 x Not used 
08—OF Resource identification 
10-13 Caller's return address 
14-17 Address of directory entry 
18—1F Network identification of resource. 
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DISC Entry for SHM Disconnect 


Entry: DISC 
VIT Option: ClO 
Event: Disconnection 


VIT Processing Module: ISTRACCI 
Control is Returned to: ISTTSCVI 


Applies to: 


This trace record is generated for X.21 short-hold mode attachments. It is written 
when a port is disconnected from a station. 


O/O/O/O/O/O/O;O/O/O;/O;O/O/O;OsO; Lj LPLiLiA;A;LiL{A;Aj1A;1A;Aj1j1zy.1 
0} 1)2/3)4)5)6)7/8)9,A|BiC|DIE} F/O) 1)2)3)4)5/6)7)8)9|AIBIC| DIE] F 


DISC |T;C}P}S} CUA HALCB | PUT 
H ADDRESS | ADDRESS 
S 
I 


Byte (hex) Contents 
00-03 Record ID: C'DISC' 


04 Task identification key 

05 Connection finite state machine (FSM; see HALCFSM in ISTHALCB for 
values) 

06 Port manager FSM (see HALPMFSM in ISTHALCB for values) 

07 X.21 short-hold mode status indicator (see PUTFLG1 in ISTPUT) 


08—OB Channel unit address of link 

OC—OF Group network control block address (ISTGRPCB) 
10-13 Link network control block address (ISTHALCB) 
14-17 Physical unit table address (ISTPUT) 

18-1F Zero. 
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DLT Entry for Directory Services Locate (Part 1) 


Entry: DLT 

VIT Option: | SSCP 

Event: Sending out a Locate Search 
VIT Processing Module: ISTRACSC 

Control is Returned to: ISTDRSDL 

Applies to: 


This trace record is written when VTAM's directory services component forwards a 
locate search to some adjacent node. 


Note: This trace record has been reformatted because of an increase in the size 
of the task vector field. 


as “baba HEE lien 
aHHE slelole eal: HAE ARE 


TASK RETURN : : LCB SENSE 
VECTOR ADDRESS E} ADDRESS | CODE 


Byte (hex) Contents 


Onamanmn 
Oo2ZzOoONoOz wm 


00—02 
03 
04 


05-07 
08—OF 


08 


09 


658  VTAM V4R2 Diagnosis 


Record ID: C'DLT' 


Zero 


ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 


zero 


The task vector bits indicate the possible tasks for this locate search. 
The hex values listed below are in the task vector and task vector 


result fields of the VIT entry. 


Vector 


X'80' 
X'40' 
X'20' 
X'10' 
X'08! 
X'04!' 
X'02! 
X'01! 


Vector 


X'80' 


X'40' 


Vector Result 

Null task 

Directory services management exit 

Directory services database query 

Topology and routing services database query 
Forward to network node server 


One hop if directory services database is found 


One hop if control vector X'OE' is received for request 
Non-verify attempt 


Vector Result 

Directed due to network node destination LU hierarchy 
received on a search request 

Directed if directory services database is found 
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OA 


0B 


0C 


OD—-OF 


10-13 
14-15 


X'20' 


X'10' 
X'08! 
X'04! 
X'02' 
X'01' 


Vector 


X'80'! 
X'40' 
X'20' 
X'10! 
X'08! 


X'04' 
X'02! 
X'01' 


Vector 


X'80' 
X'40' 
X'20' 
X'10' 
X'08' 
X'04! 
X'02' 


X'01! 


Vector 


X'80! 


X'40! 


X'20! 


X'10' 
Zero 


DLT 


Directed if the topology and routing services valid route 
selection CV is returned 

Directed if information is learned from scout search 
Directed to a directory server 

Directed to a higher function directory server 

Directed to a directory server retry 

Directed to a gateway node 


Vector Result 

Sequential directed search to alternate directory servers 
Sequential directed search to interchange nodes 

Subarea system resolution table (SRT) cache search 
Subarea search after a positive cache search 

Subarea search after a positive directory services directory 
services entry database query 

Subarea search after a negative or no cache search 
Domain broadcast search 

Originate network broadcast search 


Vector Result 

Forward network broadcast not originated by this node 

Post processing 

One-hop search request due to énd node destination LU hier- 
archy received on a search request 

A cross-subnetwork directed search due to information 
received on the original request 

A cross-network directed search due to information found in 
the directory services database. 

A directed search due to information found in the topology and 
routing services database 

Sequential directed search with the intent of finding the 
resource cross-subnetwork 

Generic cache search 


Vector Result 


A subarea search due toa SESS_INIT_INFO_RPY inter- 


process signal 

A directed search due to a SEARCH_RPY interprocess signal 
following a positive CACHE_SEARCH_RPY interprocess _ 
signal 

A directed search due to a SEARCH_RPY interprocess signal 
following a positive directory services database query 

Post processing 


Caller's return address 

The node role for this search. More than one bit can be on. 
Code Description 

X'80' CP originating LU 

X'40' CP destination LU 

X'20' NN originating LU 

X'10' NN destination LU 

X'08' Owning directory server 

X'04' Alternate directory server 
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X'02' Intermediate network server 
X'0O1' Intermediate network node directed 
Position Description 
X'80' Intermediate network node broadcast 
16 Return code from the directory services management exit 
17 Terminating condition indicates why the search ended 
Code Description 
X'00' Processing can continue 
X'04' Positive reply can be returned to parent 
X'08' Gateway reply has been received 
X'OC' Directory server reply has been received 
X'10' An error was detected by a task called from the sequencer 
X'14' Cleanup is pending after all replies are received from the search 
phase (CP session outage) 
X'24' Directory services management exit routine specified no search 
for this request 
18-1B Address of the locate contro! block for this search 
1C—1F Sense code. 
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DLT2 Entry for Directory Services Locate (Part 2) 


Entry: DLT2 

VIT Option: SSCP 

Event: Sending out a Locate Search 
VIT Processing Module: ISTRACSC 

Applies to: 


0 


0 
0 


CHRORRCHRCHECHRCHECHACHECHRCHECHECHECH CLE GU GU GU G0GR CUCU 0000 CDSG panama 
1)2|3)4)5/6)7/8|9/A|BiC|DI EJ FiO} 1)2)/3/4)5)6)7)/8)9;A/B Ci DI E|F 


DLT2 


Byte (hex) Contents 
00-03 Record ID: C'DLT2' 
04—07 Zero 
08—OF Task Vector Results 
0 Task was not invoked. 
1 Task was invoked. 
10—1F Zero. 
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DSCD Entry for Discarded PIU Buffer (Part 1) 


Entry: DSCD 
VIT Option: PIU 
Event: Discarded PIU buffer (Part 1) 


VIT Processing Module: ISTRACOT 
Control is Returned to: ISTTSCUD 


Applies to: 


This trace record is written when VTAM's TSC utility discard routine, ISTTSCUD, 
disposes of PIU buffers because of an error condition. The reason code and 
module identifier can be used to explain the reason for the discard. This entry is 
treated as an exception condition and is always traced, regardless of the VIT 
options specified, if the VIT is active. | 


Q/0/0/0/0/0/0/0)0/0/o/@/o/@/@|o]1/1/1]2)1]1/ 1/1] 1)2)1/1)1]1]1]1 
0/1/2/3/4/5/6|7|8/9|A|BIC|D/E]F|0/1;2]3|4]5|6|7)8/9|A|B|C|D/E|F 
DSCD REASN | TSCB 20 BYTES OF PIU 

CODE | ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C'DSCD' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID 
¢ Task ID 
05-07 Discard reason.code in hex (see Appendix |, “Path Information Unit 
(PIU) Discard Reason Codes” on page 1141) 
08—OB Address of TSCB 
OC-—1F First 20 characters of the PIU. 
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DSC2 Entry for Discarded PIU Buffer (Part 2) 


Entry: DSC2 

VIT Option: PIU 

Event: Discarded PIU buffer (Part 2) 
VIT Processing Module: ISTRACOT 

Applies to: 


This trace record is a continuation of the DSCD entry. 


O/O/O;O/O;O;O;O;O/O;O;O;O;O; 1; L~Lid;1j~Lj1j1jlpapiyljijiy1ji 
0}1)2)3}4)5)6)7|/8)9j/A/BI CDE} FiO) 1)2)3)4|5/6)7|8/9)A|BIC|DIE|F 
DSC2 24 MORE CHARACTERS OF THE PIU MODULE 

ID 


Byte (hex) Contents 

00-03 Record ID: C'DSC2' 

04-—1B 24 more characters of the PIU 

1C-1F ID of the module that is discarding the PIU. 
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DSP Entry for PAB Dispatch 


Entry: DSP 
VIT Option: PSS 
Event: PAB dispatch 


VIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCPD 


Applies to: 


The DSP entry marks the beginning of a PAB dispatch, which is VTAM's major unit 
of work. This unit exists until terminated by an EXIT entry. While processing, it 
might wait for other events to complete (WAIT). It resumes processing with a 
RESM entry. The unit might be interrupted by a higher priority task and continue 
when that task is finished. 


Each PAB is identified by a unique index number. VTAM uses this number to find 
the called module and then creates a VIT entry for it. 


To correlate all events associated with this unit, look for the request parameter 
header (RPH) address, which is in many trace records, and match it to the request 
parameter header (RPH) address in the DSP trace record. This unit has exclusive 
use of that request parameter header (RPH) until EXIT. 


He HEE are ABE AHHE aHRE 
He HWE 4HRE HAE HEE AHAE 


DSP |0 PST PAB CURRENT |}MODULE | RPH 
/ ADDRESS | ADDRESS | WORK ADDRESS 
ELEMENT | ELEMENT|OR DVT 
ADDRESS | ADDRESS | ADDRESS 


Byte (hex) Contents 
00-02 Record ID: C'DSP' 


03 Zero, or, for very extended PABs, PAB work element queue level dis- 
patched 
04 ID is one of the following: 


e Primary address space ID 

This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 


05 Control block ID of work element (see Apoenaix H, “Storage and 
Control Block ID Codes” on page 1137) 
06 PAB flag field (PABFLAGS) 
Bit Meaning 
Liste. eee PAB is unconditionally scheduled. 
.1.. .... PAB closedown is in progress. 
..l. .... PAB is synchronous. 
.-1 .... PAB extension is present. 
. 1... Do not dequeue work element. 


.1.. Do not detach the request parameter header Ren: 
..s. «el. Indicates a very extended PAB. 
tats aie 1 Indicates a slightly extended PAB. 
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07 


08-0B 
OC-OF 
10-13 
14-17 
18-1B 


1C-1F 


DSP 


PAB flag field (PABFLGS1) 
Bit Meaning 
ieosk, backs Switch the PST address of this PAB's major control block 
to the new PST address contained in DYPNWPST. 
.l.. .... This PAB has a data space extension. 
.-1. .... This PAB's major control block is an FMCB. 
.-l1 .... PAB can be referenced in PSW disable mode. 
. 1... PAB is persistent. 
1... APSTERM/APSINIT FMCB during PAB dispatch. 
baestei. io0e xx Reserved. 
PST address 
PAB address 
Address of work element most recently queued to the PAB 
Address of work element currently being dispatched 
Module name abbreviation (bytes 4, 5, 7, and 8 of the module name), 
PAB DVT address (high order bit of X'18' = 0), or one of the following 
abbreviations, which can represent a function or process. The module 
name might be unavailable if the PAB being scheduled is associated 
with an address space different from the current one. 
Abbreviation Stands for 


CPSS APPN session services for CP-CP sessions 

DSVC Directory services 

DIIO Disk I/O 

LUSS APPN session services for LU-LU sessions 

MST Management services and session initiation and termi- 
nation 

TRS Topology and routing services 


Request parameter header (RPH) address. 
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DTSK Entry for Detach a Subtask 


Entry: DTSK 

VIT Option: PSS 

Event: Detach a subtask 

VIT Processing Module: ISTRACPS , 

Control is returned to: The module that issued the DETACH 
Applies to: 


This trace record is written when a VTAM module detaches a VTAM subtask. 


Some subtasks are detached without generating this entry. 


0)0/0/0/0)O/0/O/O;O;/O/O/O/O;O;O} 1/1) 1) 1} 1) 1; 1p 2} 2)1j2)ij.j1jiyi 
0) 1)2)3)4)5/6;7/8/9) AB) C)/DIE| F/O) 1)/2)3)4)5;6)7)/8)9 A; BIC|D|E|F 


TR TASK NAME TCB 
DTSK |D;C} 0 or 0 ADDR 


Byte (hex) Contents 
00-03 Record ID: C'DTSK' 


ISSUER 
ADDRESS 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
05 Return code from the detach macro (ITKRC) 


06-07 Zero 

08—OF Name of the subtask being detached, or 0 
10-13 TCB address of the subtask being detached 
14-17 Zero 

18-1B Address of the issuer of the DETACH macro 
1C-—1F Zero. 
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ERP Entry for CIO Error Recovery 


Entry: ERP 
VIT Option: ClO 
Event: Error recovery for X.25 port 


VIT Processing Module: ISTRACTR (SNAP trace recording routine) 
Control is Returned to: ISTAPCES 


Applies to: 


This trace record provides error recovery information for an X.25 port. An ERP 
entry is built when error recovery is started for an X.25 port, whether for an error, 
counter overflow, or shutdown recording. 


The telecommunications subsystem or communication adapter uses two channel 
programs: a link-control channel program and a burter-pool channel program. 


ont felali delngial 
dee pleat lslalslel7 


ERP |T|Ij CUA NCB {VIRTUAL} FLAG 
: D ADDR |CAW BYTES 


Byte (hex) Contents 

00-02 Record ID: C'ERP' 

03 Type: 
OC = Control link channel program 
OD = Buffer pool channel program 


ooo nm 
mom Zzmm 


04 ID is one of the following: 

Machine ID and Task ID 

Task ID 
05-07 Channel device name in EBCDIC (either a CUA or device number) 
08 Zero 


09—0B NCB address 

OC—OF Virtual channel address word (CAW) 
10-13 Flag bytes (NCBFLAGS) 

14-15 Error code (ERCOD) in NCB or zero 
16-17 NCB sense data in NCBSENSE or zero 
18-1F Zero. 
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ERPx Entry for Error Recovery Procedures (Part 1) 


Entry: ERPB, ERPH, ERPI, ERPL, or ERPX 
VIT Option: ClO 
Event: Error recovery for channel I/O (Part 1) 


VIT Processing Module: ISTRACCI 

Control is Returned to: ISTTSCZZ 
$$ABERV1 

Applies to: 


This trace record is written during error recovery for channel I/O. 


e ERPB is generated for error recoveries at the channel interface for a BSC line 
attached to the communication adapter. 


e ERPH is generated for error recoveries at the channel interface for an SDLC 
line attached to the communication adapter. 


e ERPI is generated for communication controllers and local SNA cluster control- 
lers. 


e ERPL is generated for local non-SNA cluster controllers. 


e ERPX is generated for channel-to-channel-attached hosts and channel-attached 
IBM 3172 Interconnect Controllers. 


lel slelola elelg ‘Pali él lala 
“HHH elelp aE alala 


ERPB CUA |NCB FLAG 
ADDRESS} BYTES R : 
S C N 
M 0 S 
D E 
ERPH j{IjL NCB FLAG CSW 
DIF ADDRESS| BYTES 
S 
M 


ERPI L C} CUA |NCB FLAG jE S CSW 
N K ADDRESS| BYTES |R E 
K E C N 
S Y 0 S 
T D E 
ERPL L C} CUA |NCB FLAG S CSW 
or N K ADDRESS| BYTES E 
ERPX K E N 
S Y S 
T E 


Byte (hex) Contents 

00-03 Record ID: 
C'ERPB' for BSCLB 
C'ERPH' for HALCB 
C'ERPI' for ICNCB 
C'ERPL' for LDNCB 
C'ERPX' for XCNCB 
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04 
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ERPx 


ID is one of the following: 
° Machine ID and Task ID 
e [8a Task ID 
Link finite state machine (LFSM) or link station state (See NCBLNKST) 


Zero 
Zero 


First byte of the subchannel status word 

Channel device name in EBCDIC (either a CUA or device number) 
NCB address 

Flag bytes (NCBFLAGS) 

Error code (ERCOD) in NCB or zero 

Return code or zero 

NCB sense data (NCBSENSE) or zero 

Channel status word from NCB. 


Appendix A. VTAM Internal Trace (VIT) Record Descriptions 669 


ERP2 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


ERP2 Entry for Error Recovery Procedures (Part 2) 


Entry: 


VIT Option: 


Event: 


ERP2 
ClO 
Error recovery for channel I/O (Part 2) 


VIT Processing Module: ISTRACCI 


Applies to: 


This trace record is a continuation of the ERPB or ERPH trace entry. 


alsiele AHHE | 
aHHE AHH 


DEVICE-DEPENDENT INFORMATION 


Byte (hex) Contents 


00-03 
04-07 
08-1C 
1D 
1E 
1F 


Record ID: C'ERP2' 

Zero 

Device-dependent information shown below 
Zero | 
Error action (ERACT) or zero 

Zero 


For SDLC links (NCBTYPE=09): 


08 

09 

OA 

OB 
OC-OF 
10 
11-12 
13-1C 


Link error retry limit 

Error retry count 

Connection finite state machine 
Retry operation code 

CCW address 

Sense byte 1 

NCB sense data area 

Zero 


For BSC links (NCBTYPE=0A): 


08-0B 
11-12 
13 

14-1C 
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Zero 

Sense data froom NCBSENSE 
Error code (NCBERCOD) 
Zero. 
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ERP! or ERPL Entry for Error Recovery Procedures 


Entry: ERPI or ERPL 
VIT Option: Clo 
Event: Error recovery 


VIT Processing Module: ISTRACCI 


ERPI or ERPL 


Control is Returned to: ISTZBMOJ for LDNCB, or ISTZBMOK for ICNCB 


Applies to: 


This trace record is written during error recovery for channel I/O. 


e ERPI is generated for communication controllers and local SNA cluster control- 


lers. 


e ERPL is generated for local non-SNA cluster controllers. 


HHP HE rlPlali ALE 
sbi nee leat AHRE 


@ > f— 
moo 


ERPI DEVICE |NCB FLAG |FIC 
ADDRESS] BYTES 


Byte (hex) Contents 

00-03 Record ID: 
C'ERPI' for ICNCB 
C'ERPL' for LDNCB 


mO”m2Zzmm 


04 ID is the primary address space ID (ASID). This field is zero if the 


ASID is greater than X'FF'. 
05 Link station state (see NCBLNKST) 
06-07 Zero 


08—0B Channel device name in EBCDIC (either a device address or device 


number) 
OC-—OF NCB address 
10-13 Flag bytes (NCBFLAGS) 


14 Flag byte as follows: 
Bit Meaning 
..l. .... Exception condition occurred (IOSEX flag is on) 


” .1..... Error routine is in control (IOSERR flag is on) 


15 V0 completion code (IOSCOD) 
16-17 Sense data (IOSSNS) 
18-1F Channel status word from IOSB. 
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ESC Entry for the TPESC Macro 


Entry: ESC 
VIT Option: ESC 
Event: TPESC macro 


VIT Processing Module: ISTRACOT 
Control is Returned to: ISTESCO1 


Applies to: 


This trace record identifies the address of the next routine to get control in a desti- 
nation vector table (DVT). The PAB address identifies the process. Using the 
request parameter header (RPH) address, you can correlate this trace record to the 
DSP entry to determine when the process was dispatched. 


a alslels HHE 4HEE “RHE AHAE ARE 
ath HE AHH lelali BHHE ABBE ABBE 


DSP PAB RETURN | RPH MODULE |RPH 
ADDRESS | ADDRESS | ADDRESS | WORK 
ELEMENT |OR DVT 


Byte (hex) Contents 
00—03 Record ID: C'ESC' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 
05 Zero 
06-07 PAB offset 
08—0B Dispatch address from DVT 
OC—OF PAB address 
10-13 Address of the issuer of the TPESC macro 
14-17 RPH work element 
18-1B One of the following: 


; 


e Module name abbreviation (bytes 4, 5, 7, and 8 of the name of the 
next module to get control) 


¢ PAB DVT address (high order bit of X'18' = 0) 
1C—1F Request parameter header (RPH) Address. 
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ETSK Entry for Exit a Subtask 


Entry: ETSK 

VIT Option: PSS 

Event: Exit a subtask 

VIT Processing Module: ISTRACPS 

Control is returned to: The subtask that is terminating 
Applies to: 


This trace record is written when a VTAM subtask is about to exit and return to the 
operating system supervisor. 


This is not fully implemented for all subtask events in VITAM. There are a number 
of subtasks that terminate without this entry being generated. 


I TCB 
ETSK |D TASK NAME ADDR REG 15 


Byte (hex) Contents 

00-03 Record ID: C'ETSK' | 

04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05-07 Zero 

08—OF Name of the subtask about to end execution 

10-13 TCB address of the current subtask 

14-1B Zero | 

1C-—1F Contents of register 15. 
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EXIT Entry for the TPEXIT Macro 


Entry: EXIT 
VIT Option: PSS 
Event: TPEXIT macro 


VIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCTX 


Applies. to: 


This trace record identifies a VTAM process (PAB) that has finished executing. 
The PAB is rescheduled if more work elements are waiting to be processed. 


In most cases, the RPH (whose address is in location 1C—1F) is freed or reused © 
after this entry. One exception is the SMS dynamic expansion DYPAB 
(ATCPXPAB in module ISTORFPX), which has a dedicated RPH that is not used 
for anything else. 


This entry is the complement of DSP. An EXIT should eventually follow every 
DSP. Use the RPH address to correlate the entries. 


HH AHH alelali THHE HEE AEE 
alsla ca HBF Heals AAP sl lala ARE 


EXIT P |} PST PAB RETURN }|WORK EL|MODULE | RPH 
A |ADDRESS| ADDRESS | ADDRESS{Q OR 


Byte (hex) Contents 
00-03 Record ID: C'EXIT' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
05 TPEXIT options 
06-07 PAB offset, or zero if no PAB 


Note: There is no PAB if the running process has already freed the 
major control block that contains the PAB. 

08—0B PST address 

OC—OF PAB address, or zero if no PAB 


Note: There is no PAB if the running process has already freed the 
major control block that contains the PAB. 
10-13 Address of the issuer of the TPEXIT macro 
14-17 One of the following: 
e PAB work element queue 
e Next dispatchable queue level for a very extended PAB (see corre- 
sponding DSP entry to find the PABFLAGS to determine the PAB 
type) 
e Zero if no PAB 
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Note: There is no PAB if the running process has already freed 
the major control block that contains the PAB. 
18-1B Module name abbreviation (bytes 4, 5, 7, and 8 of the module name), 
PAB DVT address (high order bit of X'18' = 0), or one of the following 
abbreviations, which may represent a function or process. The module 
name might be unavailable if the PAB being scheduled is associated 
with an address space different from the current one. 
Abbreviation Stands for 


CPSS APPN session services for CP-CP sessions 

DSVC Directory services 

DIIO Disk I/O 

LUSS APPN session services for LU-LU sessions 

MST Management services and session initiation and termi- 
nation 

TRS Topology and routing services 


1C-1F Request parameter header (RPH) Address. 


Note: There is no PAB if the running process has already freed the major control 
block that contains the PAB. 
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EXPN Entry for Buffer Pool Expansion 


Entry: EXPN 
VIT Option: | SMS 
Event: Buffer pool expansion 


VIT Processing Module: ISTRACSM 
Control is Returned to: ISTORFBA or ISTORAPX 


Applies to: 


This trace record is generated whenever VTAM needs to expand a buffer pool. 
Buffer pool expansion may occur because of a scheduled request (if done by 
ISTORAPX) or because additional buffers are needed to satisfy a REQSTORE 
macro ( if done by ISTORFBA). 


ale AE Hie JEHE lala AHBE 
alsa HH dare HBRE wealelo 


EXPN BPCB PXB EXTENT CIF 
ADDRESS | ADDRESS | ADDRESS O|}L|NUMBER | NUMBER 
D|A| OF | 
E|/G|BUFFERS | BUFFERS 


Byte (hex) Contents 
00-03 Record ID: C'EXPN' 
04 ID is one of the following: 

e Primary address space ID 

This field is zero if the ID is greater than X'FF'. 

e Machine ID and Task ID 

e Task ID 
05-07 Zero 
08—0B Address of buffer pool control block (BPCB) for which expansion 

occurred 

OC—OF Address of pool expansion block (PXB) that is expanded 
10-13 Extent address (PXBSTADR) 


OMm@D Y_> wv 


14-15 Number of pages for an expansion in this pool. Number of pages for 
an expansion = (BPCBEXLN divided by 4096) 
16 Expansion failure code if expansion failed. 


Note: VTAM issues codes 4 through 8 when a failure occurs 
during a deferred expansion. 


Not enough CSA storage is available for the expansion. 


VTAM cannot fix pages in storage due to insufficient page frames 
or some other page locking problem. 


Storage unavailable. VTAM's CSA limit is exceeded. 


Expansion would cause the pool to exceed its xpanlim specifica- 
tion. See “Setting Buffer Pool Allocations” in the VTAM Network 
Implementation Guide for additional information about xpanlim. 


Note: [JJ VTAM issues codes 14 through 18 when a failure 
occurs during a dynamic expansion. 


14 Not enough CSA storage is available for the expansion. 
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15 VTAM cannot fix pages in storage due to insufficient page frames 
or some other page locking problem. 


VTAM might issue code 15 if the storage size of the virtual 
machine that attempts the dynamic expansion is larger than the 
starting address of the GCS shared system but not large enough 
to completely encompass all pages of the GCS shared system. 


17 Storage unavailable. VTAM’s CSA limit is exceeded. 


18 Expansion would cause the pool to exceed its xpanlim specifica- 
tion. See “Setting Buffer Pool Allocations” in the VTAM Network 
Implementation Guide for additional information about xpanlim. 


Zero 


See the explanation of IST1541 in VTAM Messages and Codes for 
more information on interpreting byte 16. 


17 Flag byte 
Bit Meaning 
Ras eae 1=ISTORFBA caused the expansion 


O=ISTORAPX caused the expansion 
-X.. ..-. | 1=PXB was allocated by this expansion 
O=PXB already existed from prior expansion 
..X. ....  1=Failure to obtain or fix storage 
0=Success in obtaining or fixing storage 
18-1B Total number of buffers in pool after this expansion (BPCBTOTL) 
1C—1F Total number of available buffers in pool after this expansion. 
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FBLK Entry for FREEBLK Macro (Part 1) 


Entry: FBLK 

VIT Option: SMS 

Event: FREEBLK macro 

VIT Processing Module: ISTRACSM 

Control is Returned to: ISTORCDF 

Applies to: 

This trace record shows the status of each FREEBLK request issued by VTAM 
components. 


The FREEBLK macro is the complement of the GETBLK macro. FREEBLK must 
release the storage obtained by GETBLK. Each GBLK entry should eventually 
have a corresponding FBLK entry. 


If the return code is non-zero, this entry is generated whether the SMS option is in 
effect or not. This event is treated as an exception condition and, therefore, is 
traced whenever the VIT is active. 


0)0/0/0/0)0)0)0;0;0;0/0/0;0;0;0)1) 1) 1) 171) 1) 172/11) 1) 1} 1; 1) 171 
0) 1)2/3/}4)5)6)7/8|9;A/B/C|D)E|F/0)1)/2)3)4)5]6)7/8|/9)A|B)C|D| Ej F 


FBLK |IjR CALLER 
D 


Byte (hex) Contents 
00-03 Record ID: C'FBLK' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
05 Return code 
06 If FBLK is followed by FBL2: 
00 AMUTSCBS 
01 AMUTSCBL 
02 CMPTAB 


If FBLK is not followed by FBL2, possible storage pool types (in hex) 
follow (see “DISPLAY STORUSE Pools” in the VTAM Network Imple- 
mentation Guide for more information on storage pools): 
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RUPEPRIV 
RUPECOMM 
SIB 
SSCPFMCB 
NQDAT 
EPTDVT 
CDRSC 
ACDEB 
HSQH 
ERTE 
WREEID 
FMCBEXT 
SIBEXT 
(Not used) 
UECB 
lIOBLOCK 
SRTE 
ISTTRCEL 
UTILPVTS 
VRPL 
POWEPRIV 
POWECOMM 
PULURDTE 
PAQ 

RAQ 
CPWAPVT 
ERICPOOL 
SIBIX 
CDAJSCP 
GWNAJSCP 
lIOSIB 
DSSIB 
UTILPVTL 
UTILCSAS 
UTILCSAL 
AMU 

HSICB 
LMTABLE 
SAB 

RAB 
PRIDBLK 
PRIDQAB 
AUTOLOGN 
CPWACSA 
PGIOBLK 
PRDLE 


RIBRANT 


CANT 

CAB 
CNSFACUD 
BFRTRACE 
DMTSQ 
FMCB 
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FBLK 


PLUSFMCB 


PXBFIXED 
PXBPAGED 
PLUSC 
NSSCB 


(Not used) 


(Not used) 
(Not used) 
FMH5 
OOBTSCB 
SLD 
NSRUS 
NSRUL 
RUCON 
STB 

WAR 
UVRPL 
DCX 
PLUSDATA 
ADJCP 
ATGB 

TGP 
KEYTOKEN 
TRSINFO 
COS 
NDREC 
TGREC 
ACPCB 
DECB 
NiDCB 
CPRUPE 
ANDCB 
DISKIO 
DSERVER 
ADJNODE 
CACHE 
ISTSITCB 
ISTENDEL 
CORCB 
LCB 

OSCB 
SCCB 
UTILAREA 
PLOCB 
TREEBLD 
UTILFIXD 
POWMPRIV 
POWMCOMM 
POAPRIV 
BFRTRFUL 
SLENT 
DYPATH 
PCDCA 
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6A BNINFO 6E MIWKE 
6B GRINS | 6F IAP 
6C BSBEXT 70 LIA 
6D SOCKET 71 IPWKE 
07 When set to 1, indicates that storage obtained through GETBLK 
request and converted to VIALLOC request is returned to system. 
08—0B Address of block freed (or zero if FREEBLK failed) 
OC—OF Address of storage pool anchor block (SPTAE) or, if FBLK is followed 
by FBL2, address of DSPSP 
10-13 Address of the issuer of the FREEBLK macro 
14-17 Length of storage actually freed not including the 8-byte header. 
18-1B Caller of utility routine or zero. If the FREEBLK macro was issued from 
a utility routine, the address of the utility's caller is placed here. A zero 
address indicates that the macro was issued directly by the caller (see 
return address) without a utility routine. 
1C-1F Zero. 
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FBL2 Entry for FREEBLK Macro (Part 2) 


Entry: FBL2 

VIT Option: SMS 

Event: FREEBLK macro 
VIT Processing Module: ISTRACSM 
Applies to: 


This trace record is a continuation of the FBLK entry; it is generated only if the 
storage that is freed is in a data space. 


FBL2 returns the address of the data space descriptor control block (DSDCB) and 
the data space name from the DSDCB. When using IPCS, the data space name is 
required to look at data in the data space. 


O;O/O/O/O/O;O/O/O/O;O/O;O/O/O;O;Ti{ Ti Li ApLiLpajlylyajiyiyijiyjiy1 
0)1)2/3/4)5)6)7;8{/9;A|B/ Ci DIE} F/O} 1)2)/31)4)5)6)7)8)/9/A\B/C|DIE| F 
FBL2 |DSDCB DATA SPACE 

ADDRESS| NAME 


Byte (hex) Contents 

00-03 Record ID: C'FBL2' 

04—07 Address of DSDCB 

08—OF Data space name from the DSDCB 
10—1F Zero. 
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GBLK Entry for GETBLK Macro (Part 1) 


Entry: GBLK 
VIT Option: SMS 
Event: GETBLK macro 


VIT Processing Module: ISTRACSM 
Control is Returned to: ISTORCDG or ISTORCGB 


Applies to: 
This trace record shows the status of each GETBLK request issued by VTAM com- 
ponenis. 


The FREEBLK macro is the complement of the GETBLK macro. FREEBLK must 
release the storage obtained by GETBLK. Each GBLK entry should eventually 
have a corresponding FBLK entry. 


If the return code is non-zero, this entry is generated whether the SMS option is in 
effect or not. It is treated as an exception condition and is always traced, regard- 
less of the SMS option, if the VIT is active. 


CHRCHACHRCHECHCORECHECHECHECHECHECHDCHECHECH ICAU GPG GUG0 0000000000 0000000000 au 
0} 1)2)3)4)5|6)7/8)/9}A)B/C}/D/E}F/0/1)2)3)4)5|6}7/8)9;A;B)C}D|E| F 


GBLK R|}P}V}STORAGE|ADDRESS}RETURN | LENGTH |CALLER 
T|0|T| ADDRESS | OF 
NIOIA 
Cy LIL 
D) IC 


Byte (hex) Contents 
00-03 Record ID: C'GBLK' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID 
¢ Task ID 
05 Return code 
06 If GBLK is followed by GBL2: 
00 AMUTSCBS 
01 AMUTSCBL 
02 CMPTAB 


If GBLK is not followed by GBL2, possible storage pool types (in hex) 
follow (see “DISPLAY STORUSE Pools” in the VTAM Network Imple- 
mentation Guide for more information on storage pools): 
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RUPEPRIV 
RUPECOMM 
SIB 
SSCPFMCB 
NQDAT 
EPTDVT 
CDRSC 
ACDEB 
HSQH 
ERTE 
WREEID 
FMCBEXT 
SIBEXT 
(Not used) 
UECB 
lIOBLOCK 
SRTE 
ISTTRCEL 
UTILPVTS 
VRPL 
POWEPRIV 
POWECOMM 
PULURDTE 
PAQ 

RAQ 
CPWAPVT 
ERICPOOL 
SIBIX 
CDAJSCP 
GWNAJSCP 
lOSIB 
DSSIB 
UTILPVTL 
UTILCSAS 
UTILCSAL | 
AMU 

HSICB 
LMTABLE 
SAB 

RAB 
PRIDBLK 
PRIDQAB 
AUTOLOGN 
CPWACSA 
PGIOBLK 
PRDLE 


RIBRANT 


CANT 

CAB 
CNSFACUD 
BFRTRACE — 
DMTSQ 
FMCB 
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PLUSFMCB 


PXBFIXED 
PXBPAGED 
PLUSC 
NSSCB 
(Not used) 
(Not used) 
(Not used) 
FMH5 
OOBTSCB 
SLD 
NSRUS 
NSRUL 
RUCON 
STB 

WAR 
UVRPL 
DCX 
PLUSDATA 
ADJCP 
ATGB 

TGP 
KEYTOKEN 
TRSINFO 
COS 
NDREC 
TGREC 
ACPCB 
DECB 
NIDCB 
CPRUPE 
ANDCB 
DISKIO 
DSERVER 
ADJNODE 
CACHE 
ISTSITCB 
ISTENDEL 
CORCB 
LCB 

OSCB 
SCCB 
UTILAREA 
PLOCB 
TREEBLD 
UTILFIXD 
POWMPRIV 
POWMCOMM 
POAPRIV 
BFRTRFUL 
SLENT 
DYPATH 
PCDCA 
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6A BNINFO 6E MIWKE 
6B GRINS 6F IAP 
6C BSBEXT | 70 LIA 
6D SOCKET 71 IPWKE 
07 When set to 1, actual GETBLK request converted to VTALLOC request 


08—0B Address of block obtained (or zero if GETBLK failed) 

OC-—OF Address of storage poo! anchor block (SPTAE) or, if GBLK is followed 
by GBL2, address of DSPSP 

10-13 Address of the issuer of the GETBLK macro 

14-17 Length of storage actually obtained, rounded to the correct subpool 
length. This length should not include the 8-byte GETBLK header. 
The storage address (bytes 08-OB) and this value represent the 
address of the next available storage. 

18-1B Caller of utility routine or zero. If the GETBLK macro was issued from 
a utility routine, the address of the utility's caller is placed here. A zero 
address indicates that the macro was issued directly by the caller (see 
return address) without a utility routine. 

1C-—1F Length of the storage specified by the user. 
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GBL2 Entry for GETBLK Macro (Part 2) 


Entry: GBL2 

VIT Option: SMS 

Event: GETBLK macro 
VIT Processing Module: ISTRACSM 
Applies to: 


This trace record is a continuation of the GETBLK entry and provides the address 
of the data space descriptor control block (DSDCB). This trace record is generated 
only if the storage that is acquired is in a data space. 


CHRCHACHACHACHACHECHACHECHACHACHICHECHECHECH UGG GR GU GR 0000000000000 00000 Gum 
0) 1)2/3/4/5/6}7)8;9;A;/B)C) DE; F/O}1)2}3)}4)5)6)7/8)9) A} Bj C}/D)E]F 
GBL2 |DSDCB DATA SPACE 

ADDRESS| NAME 


Byte (hex) Contents 

00-03 Record ID: C'GBL2' 

04—07 Address of DSDCB 

08—OF Data space name from the DSDCB. When you are using IPCS, the 
data space name is required often to look at data in the data space. 

10—1F Zero. 
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GNAM Entry for GNAME Macro Invoked (Part 1) 


Entry: GNAM 
VIT Option: SSCP 
Event: GNAME macro invocation 


VIT Processing Module: ISTRACSC 
Control is Returned to: ISTCPCGM 


Applies to: 


This trace record is written when generic mapping information in the coupling 
facility structure ISTGENERIC is created, deleted, or changed using the GNAME 
macroinstruction. 


O/O/O/O/O;O/O;O/O;O;O;O;O/O/O;O; D/L; LTiA;L{LpLpdyljij;tjdyayjijayl 
0} 1)2)/3/4)5)6)7/8)9/A/BiC|DiE| F/O; 1)2)3)4/5)6)7)8)9)A|ByC}DIJE|F 


R}F| F| GENERIC RETURN R}GENERIC| RPH 
U}L)RESOURCE ADDRESS NUMBER | ADDRESS 
N}A| NAME 
C 


Byte (hex) Contents 
00-03 Record ID: C'GNAM' 


ONO 2z-— 
OND & 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
05 Return code from the GNAME macro 
06 Reason macro invoked 
X'01' Find generic resource mapping 
X'02!' Find generic resource mapping or USERVAR 
X'03' Add the application program network name to generic 
mapping 
X'04' Delete the application program network name from generic 
mapping 
X'05' Write generic mapping to coupling facility structure 
X'06' Free local copy of generic mapping 
X'07' Find a generic resource name for an application program 
network name. 
X'08' Find the generic number for a generic resource name 
07 Event flags: 
Bit Meaning 
ISSA G The addition or deletion of an application program network 
name is due to a change in CP-CP status. 
ey rere The addition or deletion of an application program network 


name is due to a SETLOGON GNAMEADD or 
SETLOGON GNAMEDEL. 
XX XXXX Zero 
08—OF Generic name 
10-13 Address of the invoker of the GNAME macro 
14—16 Zero 
17 Resolution count or zero 
~ 18-1B The generic number if available, otherwise zero 
1C—1F Request parameter header (RPH) Address. 


686  VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” GNA2 
Licensed Materials — Property of IBM 


GNA2 Entry for GNAME Macro Invoked (Part 2) 


Entry: GNA2 

VIT Option: SSCP 

Event: GNAME macro invocation 
VIT Processing Module: ISTRACSC 

Applies to: MVS 


This trace record is a continuation of the GNAM entry. 


SESS |PCID NETID APPLICATION 


COUNT OF APPLICATION |PROGRAM 
PROGRAM NETWORK NAME 
NETWORK NAME 


Byte (hex) Contents 
00-03 Record ID: C'GNA2' 


04-07 Session count or zero 

08—OF PCID if associated with a session, otherwise zero 
10-17 Network ID of application program network name 
18-1F Application program network name. 
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HIOx Entry for Halt I/O 


Entry: HIOB, HIOH, HIOI, or HIOX 
VIT Option: CIO 
Event: Halt I/O 


VIT Processing Module: ISTRACCI 
Control is Returned to: ISTTSCLR 


Applies to: 


This trace record is written when a Halt I/O SVC is issued to end a currently exe- 
cuting channel program. 


e HIOB is generated when an HIO SVC ends a channel program ne a BSC 
line attached to the communication adapter. 


e HIOH is generated when an HIO SVC ends a channel program using an SDLC 
line attached to the communication adapter. 


e HIOI is generated when a VM GENIO HALT or an MVS HIO SVC ends a 
channel program to a local SNA controller as a result of VARY INACT,FORCE 
processing. 


e HIOX is generated when an HIO SVC ends communication between channel- 
to-channel-attached hosts. 


An HIO entry should be followed shortly by an interrupt (INT) entry. Match the 
CUAs in the HIO and INT entries to be sure they are for the same device. See : 
VTAM Data Areas for MVS/ESA or VTAM Data Areas for VM/ESA for a description 
of the NCB, ICNCB, and XCNCEB fields. 


lola alsiels Heb dBA SEE 
alt aHHE Hk 4HAE HBAE 


DEVICE |NCB FLAG 
ADDRESS; BYTES 


Byte (hex) Contents | 
00-03 Record ID: C'HIOB', ‘HIOH’, or ‘HIOX’ 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 
05 For HIOB, link station state (BSCLKFSM) 
For HIOH, link station state (HALLFSM) 
For HIOI, link state (NCBLNKST) 
For HIOX, for a channel-to-channel adaptor, station state (XCNSSFSM) 
For HIOX, for a LAN channel station, link state (NCBLNKST) 


06-07 Module ID (last 2 characters of TSC module name) 
08—0B Channel device name in EBCDIC (either a device address or device 
number) 


OC-—OF NCB address 
10-13 Flag bytes (NCBFLAGS) 
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14—1F Zero. 
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HIOP 


HIOP Entry for Halt I/O 
Entry: 


VIT Option: 


Event: 


VIT Processing Module: 
Control is Returned to: 


Applies to: 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


HIOP 

ClO 

Halt I/O 

ISTRAC6T 

ISTTSCE6L or ISTTSC6P 


This trace record is created when a Halt I/O SVC is issued to end a currently exe- 
cuting channel program. This entry might be followed by an interrupt (INT) entry. 
Match the CUAs in the HIO and INT entries to be sure they are for the same 
device. A Halt I/O SVC is issued against each of four CUAs during initialization or 
termination of the token-ring subsystem. 


Notes: 


1. The HIOP entry cannot be generated during initialization of a token-ring LAN 
attached through an IBM 3172 Interconnect Controller. 


2. The HIOP trace entry is generated during initialization. 


Byte (hex) 
00-03 
04 


05 


06-07 
08 
09-0B 
OC—OF 
10 
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alt alslals HH rlelalii2\3 


I|Cc 
D 


CUA |NCB 
ADDRESS 


Contents 

Record ID: C'HIOP' 

ID is one of the following: 
Machine ID and Task ID 


4 Task ID 
Channel program FSM 
0O Reset 
01 Sense ID 
02 = Interrupt port 
03 Control port 
04 Running 
05 Sense 
06 Orderly halt (HLTC) 
07 Termination 
08 Shutdown 


Module ID (last 2 characters of TSC module name) 


Zero 


Channel device name in EBCDIC (a device number) 
NCB address 
Port state (PDATA) 


00 Reset 

01 Halt 

02 Halt complete 
03 Sense ID 
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04 Sense ID complete 
05 Interrupt pending 


06 Active 
07 Sense 
11 Port type (PDATA) 
00 ‘Interrupt 
01 Control 
02 Inbound 


03 Outbound 
12—1F Zero. 
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INT Entry for Channel Interrupt for X.25 Port 


Entry: INT 
VIT Option: Clo 
Event: Channel interrupt for X.25 port 


VIT Processing Module: ISTRACTR (SNAP trace recording routine) 
Control is Returned to: ISTAPCES 


Applies to: | 


This trace record provides information about interruptions at the telecommuni- 
cations subsystem or communication adapter interface. An entry is built for each 
I/O interrupt for an X.25 port. 


The telecommunications subsystem or communication adapter uses two channel 
programs: a control-link channel program and a buffer-pool channel program. 


0)0/0/0/0)0)0)0)0)0)0)0/0;0;0)0)1)1)1)1) 1; 1) 1) 1) 1] 1) 1) 1)1)1)1)1 
0) 1]2/3)4)5)/6/7;/8|/9/AIByC}DIE| F/O) 1)2)/3)4]5)6)/7/8)/9/A;ByC{DIE| F 


INT |T)I] CUA | CSW SENSE STATUS CCW NCB 
Y}D 
p | 
E 


Byte (hex) Contents 
00-02 Record ID: C'INT' 
03 Type: | 
OC = Control link channel program 
OD = Buffer pool channel program 

04 ID is one of the following: 

° Machine ID and Task ID 

e [a Task ID 
05-07 Channel device name in EBCDIC (either a CUA or device number) 
08-09 Channel status word from NCB 
OA-1B NCB sense data in NCBSENSE 
1C—1F NCB address. 
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INTx Entry for Channel Interrupt (Part 1) 


Entry: INTI, INTL, or INTX 
VIT Option: ClO 
Event: Channel interrupt 


VIT Processing Module: ISTRACCI 
Control is Returned to: ISTTSCLC 


Applies to: 


This trace record is written when a channel program interrupt occurs. Every INT 
entry has a previously issued SIO entry, although it may have been issued some 
time ago. Use the CUA field to correlate SIO and INT entries. The SIO entry 
provides additional information about this completing channel program. 


See VTAM Data Areas for MVS/ESA for a description of the NCB fields. See the 
diagnostic manuals for your operating system for a description of the SIO fields. 


O/O;O/O/O/O/O;O;O/O;O/O;O/O/O;O; 1 A;L{D)Ap;LpAjplpliljpljljijljiy1 
0)1/2)3)4/5/6)7/ 8/9 A|B/C|DIE|F/O)1)2)/3)4/5)6)7/8)9|A|BIC|DIE|F 


INTI S|E]}Q|DEVICE |NCB FLAG |FICIS 0 CSW 
INTL 0 ADDRESS; BYTES |LJOJE R 
INTX A|DIN 
GjE|S 0 
E 


Byte (hex) Contents 

00-03 Record ID: 
C'INTI' for ICNCB 
C'INTL' for LDNCB 
C'INTX' for XCNCB 


oo uv 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05 Link station state (NCBLNKST) for ICNCB and LDNCB 
Station state (XCNSSFSM) for XCNCB 

06 Ending operation code 

07 Zero 

08—0B Channel device name in EBCDIC (either a device address or device 
number) 


OC—OF NCB address 
10-13 Flag bytes (NCBFLAGS) 


14 Flag byte as follows: 
Bit Meaning 
Veh vermin Running in disabled interrupt exit (IOSDIE is not zero) 


.1.. .... ERP work area address exists (IOSERP is not zero) 
..1. .... Exception condition (IOSEX flag is on) 
..l1 .... | Error routine in control ((OSERR flag is on) 


15 I/O completion code (IOSCOD) 
16-17 Sense data in IOSSNS if this was a sense channel program; otherwise, 
zero 


18-1F Channel Status word from iOSB. 
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INT2 Entry for Channel Interrupt (Part 2) 


Entry: INT2 

VIT Option: ClO 

Event: Channel interrupt (Part 2) 
VIT Processing Module: ISTRACCI 

Applies to: 


This trace record is a continuation of the INT entry. 


16/0/0/0/6/0/6/0/0/O/O/O/O;O/O;O) 1) 1) 1/1] 1] 2/1] 1}1]1]1f14)1f1]a 
0)1)2)3)4|5|6|7/8/9/A/BIC/D/E}F/ 0} 1/2) 3] 4]5/6|7/8|9;A|BIC|DIE 


INT2 MPC TRANSMIT FIRST MPC 
BLOCK HEADER PDU HEADER 


Byte (hex) Contents 

00-03 Record ID: C'INT2' 

04-07 Zero 

O08—OF MPC -transmit block header 

10-17 MPC PDU header for first PIU in the transmit buffer 
18—1F Zero. 


1 
F 
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INTx Entry for Channel Interrupt (Part 1) 


Entry: INTB, INTH, INTI, INTL, or INTX 
VIT Option: ClO 
Event: Channel interrupt (Part 1) 


VIT Processing Module: ISTRACCI 
Control is Returned to: ISTTSCLC 


Applies to: 
This trace record is written when a channel program interrupt occurs. 


e INTB is generated for interrupts at the channel interface for a BSC line 
attached to the communication adapter. 


e INTH is generated for interrupts at the channel interface for an SDLC line 
attached to the communication adapter. 


e INTI is generated for interrupts between communication controllers and local 
SNA cluster controllers. 


e INTL is generated for interrupts from local non-SNA cluster controllers. 
e INTX is generated for interrupts between channel-to-channel-attached hosts. 
Every INT entry has a previously issued SIO entry, although it may have been 


issued some time ago. Use the CUA field to correlate SIO and INT entries. The 
SIO entry provides additional information about this completing channel program. 


See VTAM Data Areas for VM/ESA for a description of the NCB fields. See the 
diagnostic manuals for your operating system for a description of the IOS fields. 


OO;O/O;O/O/O/O/O;O/O/O/O;O;O;O; 1) 1; LpLpLiLpApAyLpAp dpa; 1j1yay1 
0)1/2)3)4)5)6)7/8/9;/A}Bi/C}DJE] F/O} 1/2)3)4)5)6)7)/8)9)A|BiC)}DE|F 
CUA T} S CSW 


INTB JTL NCB FLAG 
or DIF ADDRESS| BYTES Y; E 
INTH S P| N 
M E| S 
E 
INTI CUA |NCB FLAG T| §$ CSW 
ADDRESS} BYTES GE | 
P| N 
E; S 
E 
CUA |NCB FLAG qT CSW 
ADDRESS; BYTES Y 
P 
E 
CUA |NCB FLAG |FI/T|S o CSW 
ADDRESS} BYTES |LIY|E r 
A} PIN 
GJE/S 0 
E 
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Byte (hex) Contents 
00-03 Record ID: 
C'INTB' for BSCTYPE 
C'INTH' for HALTYPE 
C'INTI' for ICNCB 
C'INTL' for LDNCB 
C'INTX' for XCNCB 
04 Machine ID and Task ID 
05 For INTB and INTH, link finite state machine (LFSM) 
For INTI and INTL, link station state (NCBLNKST) 
For INTX, station state (XCNSSFSM) 


06 For INTX ending operation code; otherwise, zero — 
07 Zero 
08 For INTB and INTH, zero 


For INTI, INTL, and INTX, first byte of the subchannel status word 
09—0B Channel device name in EBCDIC (either a CUA or device number) 
OC-—OF NCB address 
10-13 Flag bytes (NCBFLAGS) 


14 For INTX, flag byte as follows; otherwise, zero 
Bit _ Meaning 
Tiset: gas Running in disabled interrupt exit (IOSDIE is not zero) 
.1.. .... ERP work area address exists (IOSERP is not zero) 
..l. .... Exception condition (IOSEX flag is on) 
».el .... Error routine in control (IOSERR flag is on) 

15 Interrupt type (ICBTYPE) 


16-17 NCB sense data in NCBSENSE if this was a sense channel program; 
otherwise, zero 7 
18-1F Channel status word from NCB. 
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INT2 Entry for Channel Interrupt (Part 2) 


Entry: INT2 

VIT Option: ClO 

Event: Channel interrupt (Part 2) 
VIT Processing Module: ISTRACCI 

Applies to: 


This trace record is a continuation of the INT entry. 


4HHE 4HHE lS lala 
li 4HHE 4HHE SBE 


DEVICE-DEPENDENT 
INFORMATION 


Byte (hex) Contents 
00—03 Record ID: C'INT2' 
04—07 Zero 


08-13 Device-dependent information shown below 
14-—1D Zero 

1E | Error action (ERACT) or zero 

1F Zero 


For SDLC links (NCBTYPE=09): 


08 Return code 

09 Buffer offset (SPLOFFST) 

0A SDLC station address (SPLADDR) 

OB Control flag (SPLCTLFG) 

oC Current SDLC number of last I-frame sent (SPLNSCUR) 
OD Last acknowledged I-frame (SPLNSACK) 

OE Next I-frame to be received (SPLNRACC) 

OF Commanc-in field (SCXCMDIN) 

10 Count of frames sent and acknowledged (SCXCFRS) 

11 Number of receive buffers used (SCXCRBUF) 


12-13 Exception flags and exception code (SCXEXFCD) 


For BSC links (NCBTYPE=0A): 


08 First selection character (BSCSEL1) 

09 First device address (BSCDEV1) 

0A Index of BPL entry for which input data was received (BSCPESV) 
OB Device address from which input data was received (BSCDEVSV) 
oC Index for last station for which there was output data (BSCISOD) 
OD First response byte (BSCRSPA1) 

OE Second response byte (BSCRSPA2) 

OF Last block type received (BSCLBR) 

10 Current acknowledgment (BSCALTAK) 

11 Error retry count (BSCRCNT) | 

12 Connection manager flags (BSCCMIO) 

13 BSC flags (BSCFLAGS). 
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INTx Entry for Channel Interrupt (Part 1) 


Entry: INTB, INTH, INTI, or INTL 
VIT Option: Clo 
Event: Channel interrupt (Part 1) 


VIT Processing Module: ISTRACCI 
Control is Returned to: ISTTSCLC 


Applies to: 
This trace record is written when a channel program interrupt occurs. 


e INTB is generated for interrupts at the channel interface for a BSC line 
attached to the communication adapter. 


e INTH is generated for interrupts at the channel interface for an SDLC line 
attached to the communication adapter. 


e INTI is generated for interrupts between communication controllers and local 
SNA cluster controllers. 


e INTL is generated for interrupts from local non-SNA cluster controllers. 
Every INT entry has a previously issued SIO entry, although it may have been 


issued some time ago. Use the CUA field to correlate SIO and INT entries. The 
SIO entry provides additional information about this completing channel program. 


See VTAM Data Areas for VSE/ESA for a description of the NCB fields. See the 
diagnostic manuals for your operating system for a description of the IOS fields. 


sie slalols Hae Pletal HAE 
4HHh HHH HE ABBE 


INTB CUA |NCB FLAG 
or ADDRESS| BYTES 0 : 
INTH | |S D| N 
M E| s 
E 
INTI [IIL NCB FLAG |E|C| S CSW 
N ADDRESS| BYTES |R|O| E 
K | C|D} N 
S O|E| S 
i | D| | E 
INTL {TIL CUA |NCB FLAG |@/C 
DIN ADDRESS| BYTES | |0 | 
K D 
S E 
; 


Byte (hex) Contents 

00-03 Record ID: 
C'INTB' for BSCTYPE 
C'INTH' for HALTYPE 
C'INTI' for ICNCB 
C'INTL' for LDNCB 

04 Task ID 
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05 


06—08 
09—-0B 
OC-—OF 
10-13 
14 

15 
16-17 


18—1F 


INTx 


For INTB and INTH, link finite state machine (LFSM) 

For INT! and INTL, link station state (NCBLNKST) 

Zero 

Channel device name in EBCDIC (either a CUA or device number) 
NCB address 

Flag bytes (NCBFLAGS) 

ERCOD or zero 

I/O completion code (IOSCOD) 

Actual sense data from the channel if this was a sense channel 
program; otherwise, zero 

Channel status word from NCB. 
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INT2 Entry for Channel Interrupt (Part 2) 


Entry: INT2 

VIT Option: CiO 

Event: Channel interrupt (Part 2) 
VIT Processing Module: ISTRACCI 

Applies to: 


This trace record is a continuation of the INT entry. 


aaa slay i 


DEVICE-DEPENDENT 
INFORMATION 


Byte (hex) Contents 
00-03 Record ID: C'INT2' 
04-07 Zero 


08-13 Device-dependent information shown below 
14-—1D Zero 

1E Error action (ERACT) or zero 

1F Zero 


For SDLC links (NCBTYPE=09): 


08 Return code 

09 Buffer offset (SPLOFFST) 

OA -SDLC station address (SPLADDR) 

OB Control flag (SPLCTLFG) 

oC Current SDLC number of last |-frame sent (SPLNSCUR) 
OD Last acknowledged I-frame (SPLNSACK) 

OE Next |-frame to be received (SPLNRACC) 

OF Commanc-in field (SCXCMDIN) 

10 Count of frames sent and acknowledged (SCXCFRS) 

11 Number of receive buffers used (SCXCRBUF) 


12-13 Exception flags and exception code (SCXEXFCD) 


For BSC links (NCBTYPE=0A): 


08 First selection character (BSCSEL1) 

09 First device address (BSCDEV1) 

OA Index of BPL entry for which input data was received (BSCPESV) 
OB Device address from which input data was received (BSCDEVSV) 
oC Index for last station for which there was output data (BSCISOD) 
oD First response byte (BSCRSPA1) 

OE Second response byte (BSCRSPA2) 

OF Last block type received (BSCLBR) 

10 Current acknowledgment (BSCALTAK) 

11 Error retry count (BSCRCNT) 

12 Connection manager flags (BSCCMIO) 

13 BSC flags (BSCFLAGS). 
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INTP Entry for Channel Interrupt 


Entry: INTP 
VIT Option: ClO 
Event: Channel interrupt 


VIT Processing Module: ISTRAC6T 
Control is Returned to: ISTTSC6E 


Applies to: 


This trace record is created when a channel program interrupt occurs. The entry 
may signal the completion of a channel program; if so, it has a previously-issued 
SIO entry. Use the CUA field to correlate SIO and INT entries. The SIO entry 
provides additional information about a completing channel program. 


mo © 
mon arm 


LAN major node's NCB. 
Byte (hex) Contents 
Machine ID and Task ID 
00 Reset 
03 Control port 
06 Orderly halt (HLTC) 
06-08 Zero 


The CUA field may contain the address specified on the PORT definition statement 
tb a + Als els 
aT le - AE ah le a -f 
00-03 Record ID: C'INTP'. 
Wa Task ID 
01 Sense ID 
04 Running 
07 Termination 
09—0B Channel device name in EBCDIC (either a CUA or device number) 


for a LAN major node. If so, the value in the NCB address field corresponds to the 
INTP [IIC CUA {NCB Q |S;C{S ENDING CSW 
D} ADDRESS 

04 ID is one of the following: 
05 Channel program FSM 

02 Interrupt port 

05 Sense 

08 Shutdown 
OC—OF NCB address 


10 Port state (PDATA) 
0O Reset 
01 Halt 
02 Halt complete 
03 Sense ID 


04 Sense ID complete 
05 = Interrupt pending 
06 Active 
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INTP 


11 


12-13 
14 


15 


16 


17 
18-1F 
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07 Sense 
Port type (PDATA) 
0O Interrupt 


01 Control 
02 = Inbound 
03 Outbound 
Zero 


I/O stimulus for FSM manager 

06 Normal completion 

07 Attention 

08 Attention and unit exception 
09 Unit check 
OA Error 


Channel-command code for the last CCW _ 


04 Sense (3088 compatibility) 
08 TIC 

C1 Data buffer write 

C2 Data buffer read 

C4 Sense control unit state 
C5 Control block write 

C6 Control block read 

C7 Data synchronization 

C9 Data parameters write 
CB Set CETI mode on 

CD Interrupt parameters write 
E4 Sense ID 

First byte of sense data 

80 Command reject 

02 Control block reject 

Zero 

Channel status word. 
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101 


101 Entry for TPIO Request (Part 1) 


Entry: 

VIT Option: 

Event: 

VIT Processing Module: 
Control is Returned to: 


101 

API 

Application program request (Part 1) 
ISTRACAP 

ISTAPCRS or ISTOCCSM 


This trace record shows API requests. It also provides the RPL information sup- 
plied by a VTAM application program when it issues an RPL-based macroin- 
struction (such as SEND or OPNDST). The API routine ISTAICIR issues the TPIO 
SVC. ISTAPCTI gets control from the SVC, does validity checking, and queues the 
RPL to the PST request PAB. After the PST request PAB is dispatched, 
ISTAPCRS gets control and writes the entry, or calls ISTOCCSM to write the entry. 


Applies to: 


See “RPL Fields Set by VTAM’ in VTAM Programming for an explanation of the 
RPL fields. 


The process that is started with this event will be completed by a post (UP), or an 
exit (RE or UE). To correlate the two entries, match the RPL addresses. 


0/0/0/0/0/0;0/0/0;0/O/O/O/O;O;0) 1) 1) 1) 1) 1) 1) 1) 172) 2) 2; 1p2)2)141 
0} 1)2/3)4)5/6/7/8/9/A|BIC|D)E}F/O}1)/2/3)4)5)}6}7/8)9|A\BIC}D/E| F 


0} RPL 


Byte (hex) 

00—02 

03 
X'15! 
X'16' 
X'17' 
X'19' 
X'1A' 
X'1B' 
X'1F' 
X'22' 
X'23' 
X'24!' 
X'25' 
X'27' 
X'28' 
X'29' 
X'2A' 
X'2C' 


101 |R|I|E/O RIS|vivjc|RU | OPTC2 | oPTC3 
E|D|X|P| P| ADDRESS | ADDRESS |H|R|T|T]H| CNTL 
Q} |TITIT OR CID {3]/T\F/F/N{CODE | 
T] |D | YILIL 
Y} |s{4]1 pl1|2 


Contents 
Record ID: C'lO1' 
RPL request type (RPLREQ) 


SETLOGON 
SIMLOGON 
OPNDST 
CHANGE 
INQUIRE 
INTRPRET 
CLSDST 
SEND 
RECEIVE 
RESETSR 
SESSIONC 
SENDCMD 
RCVCMD 
REQSESS 
OPNSEC 
TERMSESS 


04 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID {JJ 


Appendix A. VTAM Internal Trace (VIT) Record Descriptions 703 


101 
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¢ Task ID 
Exit definition (RPLEXTDS) 
Option code byte 4 (RPLOPT4) 
Option code byte 1 (RPLOPT1) 
RPL address 
NIB address or CID | 
Third byte of RH (RPLRHS3) 
Send/receive type (RPLSRTYP) 
VTAM flags (RPLVTFL1) 
Post/respond flags (RPLVTFL2) 
RU chain position (RPLCHN) 
RU control codes (RPLCNTRL) 
VTAM options (RPLOPTC2) 
VTAM options (RPLOPTC3). 
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102 Entry for TPIO Request (Part 2) 


Entry: 102 

VIT Option: API 

Event: Application program request (Part 2) 
VIT Processing Module: ISTRACAP 

Applies to: 


This trace record is a continuation of the 101 entry. It shows additional information 


ale 
BE 


about the request. 


NAME (if available) 
(if available) 


Byte (hex) Contents 

00-02 Record ID: C'lO2' 

03 Zero 

04-07 Address of the issuer of the macro 

O8—OF For SIMLOGON, OPNDST, CLSDST, or REQSESS: Logon mode 
name (NIBLMODE) or zero if the NIB is not available 
For OPNSEC or TERMSESS: Zero 

10-17 Application LU name if available. 

18-1F Partner LU name if available. 
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102 Entry for TPIO Request (Part 2) 


Entry: 102 

VIT Option: | API 

Event: Application program request (Part 2) 
VIT Processing Module: ISTRACAP 

Applies to: 


This trace record is a continuation of the 101 entry. It shows information about the 
PLU and SLU, such as some of the parameters exchanged and the names of the 
PLU and SLU. 


4b fh 4} 1 HE IE 
ft 4h 4H nt AHE 
102 RETURN |LOGON MODE NAME}PLU NAME SLU NAME 
ADDRESS or 0 (if available) |(if available) 


Byte (hex) Contents 
00-02 Record ID: C'lO2' 


03 Zero 

04—07 Address of the issuer of the macro 

08—OF Logon mode name (NIBLMODE) or zero if the NIB is not available 
10—17 Primary logical unit (PLU) name or zero 

18-1F Secondary logical unit (SLU) name or zero. 
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1O3 Entry for TPIO Request (Part 3) 


Entry: 103 

VIT Option: API 

Event: Application program request (Part 3) 
VIT Processing Module: ISTRACAP 

Applies to: 


This trace record is a continuation of the 102 entry. It shows additional information 
about the request. 


O/O/O/O/O;/O;O;O;O;O/O;O;O;O;O;O; 1; Lili ApApL{LiLpaAp1p1pijajay7 
071/2)314/5/6;7;8;/9;A;BiC)/ DE} F/O) 1)2/3)}4)5)6)7/8)9/A}B/C)D/E|F 


103 ADDRESS| TARGET LU NETID| TARGET LU NAME PARTNER LU 
(if available) NETID 
(if available) 
OR 0 


Byte (hex) Contents 
00-02 Record ID: C'lO3' 


03 Zero 
04—07 For SIMLOGON, CLSDST, or REQSESS: Address of user data 
(RPLAREA) 


For OPNDST or OPNSEC: Address of BIND (NIBNDAR) or zero if the 
NIB is not available 
08—OF Target LU network identifier (when for CLSDST PASS). 
Byte (hex) Contents 
08—09 Count of node initialization blocks (NIBs) in NIB list (when 
not for CLSDST PASS). 
OA-0B Count of node initialization blocks (NIBs) in NIB list with 
NIBRPARME=O (when not for CLSDST PASS). 
10-17 Target logical unit name, if available, or zero 
18—1F Partner LU network identifier, if available. 
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103 Entry for TPIO request (Part 3) 


Entry: 103 

VIT Option: API 

Event: Application program request (Part 3) 
VIT Processing Module: ISTRACAP | 

Applies to: 


This trace record is a continuation of the |O2 entry. 


ele AHH aH | 
4H ele 


Byte (hex) Contents 

00-02 Record ID: C'lO3' 

03 Zero 

04—07 Address of BIND (NIBNDAR) or zero if the NIB is not available 
08—1F Zero. 
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IPC Entry for Socket API Call Completion 


Entry: IPC 
VIT Option: TCP 
Event: When a simulated socket API call completes 


VIT Processing Module: ISTRACIP 
Control is Returned to: ISTIPCAS 


Applies to: 
This trace record is written when a socket API that was previously issued com- 
pletes. 


The trace record indicates which call was issued and which socket the call was 
issued for. It also indicates which subtask the call was issued from and points to 
the VTAM control block that represents the socket/session association. 


See Table 80 on page 1165 to determine what book contains more information 
about the socket API calls. 


ae ae 4H HME ae pela aa aHHE 
alolalelelo AeA HBAE SHRERBGE 


SOCKET |SOCKET | SOCKET RPH 
I 
D 


Byte (hex) Contents 
00-03 Record ID: C'IPC' 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
05 IUCV return code 


Code Meaning 
X'FF' Issue last error call to get return code 
X'00' No IUCV error 
X'01' IUCV-related érror 
X'02' IUCV path severed 
06-07 Zero 
08-09 Socket API call number 
OA-0B Socket descriptor or 0 
OC-—OF Socket major control block address 
10-13 Socket application subtask control block address 
14-17 Socket API Parameter List Address 
18-19 Socket API call return code — 
1A-1B Socket API call error number 
1C-—1F Request parameter header (RPH) Address. 
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IP! Entry for Socket API Call 


Entry: IPI 
VIT Option: TCP 


Event: When VTAM code issues a simulated socket API call 
VIT Processing Module: ISTRACIP | 
Control is Returned to: ISTIPCAS 

Applies to: | 


This trace record is written when socket API calls are made to send/receive data on 
an internet protocol (IP) network. 


The trace record indicates which call is being issued and which socket the call is 
being issued for. It also indicates which subtask the call is being issued from and 
points to the VTAM control block that represents the socket/session association. 


See Table 80 on page 1165 to determine what book contains more information 
about the socket API calls. 


0/0/0/0)0/O)/O/O/O/O/O/O)O;O;O;O; 1) 1) 1p; 1y1pLip1pajlpijajijijijij. 
Oj) 1; 2/3/41 5; 6; 718 /9AIBIC DIE; FiO;1)2)3)4)5);6;7)8\9;AIBIC|DIE|F 


RPH 
I ADDRESS 
D : 


Byte (hex) Contents 

00-03 Record ID: C'IPI' 

04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05-07 Zero 

08—09 Socket API call number 

OA-0B Socket descriptor or 0 


OC—OF Socket major control block address 

10-13 Socket application subtask control block address 
14-17 Socket API parameter list (ISTSOAPI) address 
18-1B Zero 


1C—1F Request parameter header (RPH) Address. 
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IRBD Entry for IRB Dispatch 


Entry: IRBD 
VIT Option: PSS 
Event: IRB dispatch 


VIT Processing Module: ISTRACPS | 
Control is Returned to: ISTAPCIE 
Applies to: 


This trace record provides information when an interrupt request block (IRB) is dis- 
patched. See Table 80 on page 1165 to determine what book contains a map of 
the TCB. 


Note: For this trace record to be created, in addition to specifying the PSS option 
you must specify IRB or BOTH on the PSSTRACE start option. 


O/O/O/O/O/O;O/O;O/O;O/O;O;O;O;O;1pLiLpLpAylpLplidylyly1p1ii1j1y1 
0) 1)2/3/4/516)7/8)9;A;BiC|D/E|F)0;1)/2)3)4/5)6)7;/8)9;A;B/C/D) EF 


IRBD {I PST TRB TCB F 
D ADDRESS | SYNC ADDRESS |ADDRESS| L 
TPPOSTD | NORMAL G 

1 


Byte (hex) Contents 

00-03 Record ID: C'IRBD' 

04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05-07 Zero 

08—O0B PST address 

OC-—OF PST synchronous TPPOSTed queue anchor (PSTSTPP) 

10-13 PST synchronous normal queue anchor (PSTSNRM) 

14-17 IRB address (TCBRBP) 

18-1B TCB address (PSTTCBA) 

1C-—1D PST flags (PSTFLG1) 

1E-1F Zero. 
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IRBX Entry for IRB Exit 


Entry: IRBX 
VIT Option: PSS 
Event: IRB exit 


VIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCSD 
Applies to: 


This trace record provides information about an IRB exit. 


Note: For this trace record to be created, in addition to specifying the PSS option 
you must specify IRB or BOTH on the PSSTRACE start option. 


O/O/O/O/O/O/O;O/O/O;O;O;O/O;O;O; A; DILL Tp1pDiljpljaylidjlyayaiy. 
0) 1)2)3)4)5/6}/7/8/9)A|/BiC|D)E} F/O) 1)2)3)4/5)/6/7/8)/9)A|B/C}D|E|F 
TRBX PST NEW TCB/OLD TCB| NEW IRB 
ADDRESS | ADDRESS | ADDRESS | ASCB 
| ADDRESS | ADDRESS 


Byte (hex) Contents 

00-03 Record ID: C'IRBX' 

04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05-07 Zero 

08—0B PST address 

OC-—OF New TCB address 

10-13 Old TCB address 

14-17 New ASCB address 

18-1B Old ASCB address 

1C-1F IRB address. 
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LCSx Entry for LAN Channel Station Error (Part 1) 


Entry: LCSL, LCSP, LCSS, or LCSX 
VIT Option: LCS 

Event: LAN channel station error (Part 1) 
VIT Processing Module: ISTRACLS 

Applies to: 


lf the LCS trace option is specified, an LCSX trace record is created for every data 
frame VTAM receives from or sends to an IBM 3172 Interconnect Controller. 


If the VIT is active and VTAM receives a frame that is not valid from an IBM 3172 
Interconnect Controller, an LCSL, LCSP, or LCSS trace record is created 
depending on the following error conditions. 


Note: These records are created as an exception condition. 


e The LCSL trace record is created when VTAM receives link-related data that is 
not valid. 


e The LCSP trace record is created when VTAM receives adapter-related data 
that is not valid. 


e The LCSS trace record is created when VTAM receives SAP-related data that 
is not valid. 


SHRCH RCH ACH ECHRCHECHECHECHECHECERCHECHDCHECHECI EGU CU GUS 0000000 C0000 000000 ana. 
0)1/2/3/4/5)6/7/8/9;A/B/C/DJE]F/0)1)2)31/4)5/6)7/8)9j/A\B\CIDIE|F 


D/A/T;/DEVICE |CB REQUEST|DATA {DATA |S/Cj 0 

IDLY ADDRESS|MODULE | LENGTH |ADDRESS|T)/0 

R}AjP ABBREV D 
iPIE | NAME E 


Byte (hex) Contents 
00-03 Record ID: 
C'LCSL' for information about a link 
C'LCSP' for information about an adapter 
C'LCSS' for information about an SAP 
C'LCSX' for information about a channel 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
05 Direction , 


~cT Pr oO 


mo > 


Code Meaning 
C'l' Data received inbound 
C'O' Data sent outbound 


06 Adapter number 

07 Adapter type 
0 = Control communication 
2 = 802.5 (token-ring) 
4 = CSMA/CD-802.3 
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5 = 802.4 (token-bus), MAP 3.0 
6 = FDDI (fiber distributed data interface) 
08—OB Channel device name in EBCDIC (either a device address or device 
number) 
OC—OF Control block address 
e For LCSL, address of LSNCB 
e For LCSP, address of PRTCB 
e For LCSS, address of SAPCB 
e For LCSX, address of XCNCB 
10-13 Requesting module abbreviated name 
14-17 Data length 
18—1B Data address 
1C FSM state 


For LCSL: 

00 Non-switched/switched reset 

01 Non-switched add SAP User 

02 Non-switched delete SAP user 

03 Non-switched pending deallocation 

04 Non-switched link active 

05 Non-switched open station 

06 Non-switched test local 

07 Non-switched test global 

08 Non-switched negotiable 

09 Non-switched primary 

OA Non-switched connect requested 

OB Non-switched pending connect indication 
OC Non-switched station active 

OD Non-switched close station 

81 Switched add SAP user 

82 Switched delete SAP user 

83 Switched pending deallocation 

84 Switched link active 

85 Switched inbound answer any 

86 Switched inbound poll pending 

87 Switched inbound XID pending 

88 Switched inbound pending contact 

89 Switched inbound open station 

8A Switched outbound answer specific 

8B Switched outbound open station 

8C Switched outbound test local 

8D Switched outbound test global 

8E Switched outbound XID pending 

8F Switched outbound XID3 pending 

90 Switched outbound pending contact 

91 Switched pending abandon connection 
92 Switched pending abandon connection out 
93 Switched pending abandon connection, no station 
94 Switched pending abandon connection out, no station 
95 Switched close station 

96 Switched answer off 

97 Switched negotiable 1 

98 Switched negotiable 2 
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99 Switched negotiable 3 
9A Switched primary 
9B Switched secondary 
9C Switched connect requested 
9D Switched pending connect indication 
9E Switched station active 
9F Switched inbound XID negotiation-preceding pending 
For LCSP 
00 Reset 
01 Add channel user pending 
02 Adapter enable pending 
03 Active 
04 Adapter disable pending 
05 Delete channel user pending 
06 _=Inoperative 
07 Blocked 
For LCSS: 
00 Reset 
01 Add port user pending 
02 Add SRM entry pending 
03 Activate SAP pending 
04 Active 
05 Deactivate SAP pending 
06 Delete SRM entry pending 
07 Delete port user pending 
08 __Inoperative 
09 Blocked 
For LCSX: 
00 Reset state 
01 X-side I/O pending 
02 Y-SIDE I/O pending 
03 Contact wait 
04 Contact wait DCM 
05 XID7 1 pending 
06 XID7 2 pending 
07 XID bad pending 
08 XID7 1 I/O pending 
09 XID7 2 I/O pending 
OA XID bad I/O pending 
OB Ready 
OC Discontact scheduled 
OD HDV pending 
OE HDV pending DCM 
OF  Discontact pending 
1D Reason code 
00 Successful 
04 Exit PAB immediately 
08 Entire primitive length is not valid 
OC Buffer allocation failed 
10 Length of primitive header is not valid 
14 Length of data field is not valid 
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18 Incorrect target layer identifier 

1C Incorrect identifier type 

24 Correlator ID mismatch 

28 Incorrect parameter list version 

2C_C~Primitive received in wrong state 

30 Unrecognized primitive code 

34 Incomplete primitive header 

38 User_sap_id provided is not valid 

58 Length of routing vector (if included) is not valid 

5C XID command/response value is not valid 

60 =Poll/final indicator is not valid 

64 Unexpected XID type 

68 Negative confirm received 

6C User class is not valid 

70 _~_Flow action value is not valid 

74 SAP not net manager capable 

78 Not valid for net manager SAP 

7C_ Vector length field is not valid in adapter-specific overlay 

80 Length of adapter-specific overlay field is not valid 

84 Vector identifier field is not valid 

88 Destination MAC/Destination SAP reporting field is not valid 

8C Identifier (user_sap_id or user_cep_id) inconsistent with identifier 
type 

94 Not valid for logon type 

98  Test/XID remote MAC/remote SAP does not match an entry in 
the SAP user matrix (SUM), and SUM has no “answer any” 
entries available 

9C Pacing fields not zero 

AQ Success count not X'FF' 

A4  user_cep_id value not in SAP user matrix (SUM) range or SUM 
entry not in use or answer mode not specific for SUM entry 

A8 Adapter inactive 

AC No match in adapter routing table found or incorrect LAN type 

BO XCNCB 8 byte header error — 

B4 XCNCB byte count mismatch 

B8 XCNCB bad primitive offset 

1E-1F Zero. 
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LCS2 Entry for LAN Channel Station Error (Part 2) 


Entry: LCS2 

VIT Option: LCS 

Event: LAN channel station error (Part 2) 
VIT Processing Module: ISTRACLS 

Applies to: 


This trace record is a continuation of the LCSL, LCSP, LCSS, or LCSX entry. 


The VTAM internal trace will generate as many as 31 LCS2 records for the LCSL, 
LCSP, LCSS, and LCSX entries. 


LCS2 UP TO 28 BYTES OF CHANNEL DATA 


Byte (hex) Contents 
00—03 Record ID: C'LCS2' 
04—1F Up to 28 bytes of channel data. 
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LCSM Entry for MACaddress for DATA SEND/RECEIVE 


Entry: 
VIT Option: 
Event: 


LCSM 
LCS 
MACaddress for DATA SEND/RECEIVE 


VIT Processing Module: ISTRACLS 


Applies to: 


If the LCS trace option is specified, an LCSM trace record is created for every data 
frame VTAM sends/receives from an IBM 3172 Interconnect Controller. 


The LCSM trace record is created in association with an LCSX entry. However, 
because these trace entries are created by different component elements, the 
entries may be separated in the trace by other component traces. For outbound 
data the LCSM entry will appear before the LCSX entry. For inbound data the 
LCSM entry will appear following the LCSX entry. 


LCSM {I 
D 


Byte (hex) 
00-03 
04 


05 


06—0B 
0C-—O0D 


OE-13 
14-17 
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COUCH RCH ECHECHECHECHICHACHECHICHACHECHECHECH CP GU GU GU 00000000 0000000000000 a0 
0} 1)2)3/4/5)6)7)8/9/A)BjC)DIE} F/O) 1) 2)3)4/5)6)7)8) 9; ABCD E|F 


D|DESTINATION| L | SOURCE INDEX1 | INDEX2 
IT}MACADDRESS ; A |MACADDRESS 
R 


Contents 
Record ID:C'LCSM' for information about macaddress 
ID is one of the following: 
e Primary address space ID 
- This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 
Direction 
Code Meaning 
C'l' Data received inbound 
C'O' Data sent outbound 
Destination macaddress 
LAN Operation 


Note: It is not required that users of the product know the meaning of 
this internal VTAM name. When required, the product support organ- 
ization may use it to assist in internal flow diagnosis. 

Source MACaddress 

Index 1 


Note: It is not required that users of the product know the meaning of 
this internal VTAM name. When required, the product support organ- 
ization may use it to assist in internal flow diagnosis. 
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18-1B Index 2 


Note: It is not required that users of the product know the meaning of 
this internal VTAM name. When required, the product support organ- 
ization may use it to assist in internal flow diagnosis. 

1C-1F RPH address. 
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LICx Entry for LAN Interface Command 


Entry: LICI, LICO, or LICS 
VIT Option: ClO 
Event: LAN interface command 


VIT Processing Module: ISTRAC6T 
Control is Returned to: ISTTSCE6R for LICI 
ISTTSC6W for LICO 
ISTTSC6K or ISTTSCE6R for LICS 


Applies to: 


One of these trace records is created when a command is sent to or received from 
the token-ring subsystem. 


An LICI record is written when a command is received from the subsystem. This 
entry always corresponds to a previous ADPA or ADPI entry. Use the TSCB 
address to correlate these entries. 


An LICO record is written when a command is ready to be sent to the subsystem. 
If the command is transferring a PIU onto the ring, it corresponds to a previous PIU 
entry. The TSCB continuation address of the LICO entry correlates to the TSCB 
address of the PIU entry. 


An LICS record is written when a special condition related to controlling the sub- 
system is detected. 


AH HHHE AHHE alaeiciwlel: 
HH HH HE alelel7 aalcigetetele 


LICI CUA | TSCB NCB C;} CMD F 
LICO ADDRESS | ADDRESS : F f L 
S S A 
M M G 
S S S 

REASON 


n=sann-4 


LICS CUA | TSCB NCB C; CMD 
ADDRESS | ADDRESS |B 
I 
D 


Byte (hex) Contents 
00-03 Record ID: 
C'LICI' for an inbound record 
C'LICO' for an outbound record 
C'LICS' for a special record 
04 ID is one of the following: 
Machine ID and Task ID 
(Sa Task ID 
05-07 Channel device name in EBCDIC (either a CUA or device number) 
08—0B TSCB address 
OC-—OF NCB address 
10 Control block ID of NCB 
OE NCEB for local station (VTAM) 
OB NCEB for remote station 


720 VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


11-13 


LICx 


Command (see “Command Values Reported in Trace Entries (VM) 
(VSE)” on page 547 for more information about this field) 


14 LLC port FSM (TFSMS) 
01 Logon pending 
02 Logon completion 
03 Logoff pending 
04 Enable pending 
05 Disable pending 
15 Channel program FSM (TFSMS) 
00 Reset 
01 Sense ID 
02 = Interrupt port 
03 Control port 
04 Running 
05 Sense 
06 Orderly halt (HLTC) 
07 Termination 
08 Shutdown 
For LICI or LICO: 
16 LLC link FSM if CBID=X'0B' (VLNLFSM) 
00 Reset 
10 ACTLINK pending 
20 =Active 
30 DACTLINK pending 
17 LLC connection FSM if CBID=X'0B' (VLNCFSM) 
00 Reset 
10 XIDO pending 
20 Connect out 
30 Connected 
40 XID pending 
70 Determined primary 
80 Non-activation XID3 pending 
18 LLC station FSM if CBID=X'0B' (VLNSFSM) 
00 Reset 
10 XID zero pending 
20 Set mode pending 
30 Set mode wait 
40 _ Active state 
50 Request discontact 
60 Disconnect pending 
19-1B Remote station (VLNCB) flags if CBID=X'0B' 
19 VLNFLAG1 
1A VLNFLAG2 
1B VLNFLAG3 
1C-—1F TSCB continuation address 
For LICS: 
16—1F Special reason text: 
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C'DISCARD' Subsystem input has been discarded. 

C'FINAL TERM' Channel programs to the subsystem have been 
stopped. | 

C'HALT RQST' VTAM is initiating shutdown of the subsystem. 
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LKEX Entry for TPLOCK Exclusive 


Entry: LKEX 
VIT Option: LOCK 
Event: TPLOCK exclusive 


VIT Processing Module: ISTRACLK 
Control is Returned to: ISTAPC36 


Applies to: 


This trace record identifies a request for exclusive control of a VTAM lock and the 
current status of a lock. Exclusive locks can be held by only one VTAM process. If 
a WAIT entry immediately follows this entry, it could be because a wait-for-lock 
condition exists. Look at the lockword in the trace output to see if the lock is 
already held. 


Locks obtained by LKEX are eventually released by UNLK or ULKA. See Table 7 
on page 80 for a list of VTAM locks. 


O/O/O/O;O;O;O;O;O/O;O;O;O;O;O;O; 1) 1pLPLiLpLpijLplylpiajijzy1i1y. 
0}1)2)3)4/5/6)7/8)9|A/BIC| DIE} F/O) 1)2)3)4)/5)6)7/8)9 AB C|DJE;F 


LKEX L L| LOCK CRA RETURN LOCKWORD RPH 
O E|/ADDRESS} LKACT | ADDRESS ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C'LKEX' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID 
¢ Task ID 
05 Zero 
06-07 Level of lock to be obtained 
08—OB Address of lock to be obtained 
OC—OF CRA lock account word (CRALKACT; see step 11 on page 79) 
10-13 Address of the issuer of the TPLOCK macro 
14-1B Lockword pointed to by address in bytes 08-0B 
1C—1F Request parameter header (RPH) Address. 
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LKSH Entry for TPLOCK Shared 


Entry: LKSH 
VIT Option: LOCK 
Event: TPLOCK shared 


VIT Processing Module: ISTRACLK 
Control! is Returned to: ISTAPC35 


Applies to: 


This trace record identifies a request for a shared VTAM lock and the current status 
of a lock. Shared locks can be held by more than one VTAM process at a time. If 
a WAIT entry immediately follows this entry, it may be because a wait-for-lock con- 
dition exists. Look at the lockword in the trace output to see if the lock is already 
held. | 


Locks obtained by LKEH are eventually released by UNLK or ULKA. See Table 7 
on page 80 for a list of VTAM locks. 


0)}0)0)0)0)0/0/0)0)0)0)0)/0)0)0)0) 1) 1) 1) 1) 1)1)1)1) 1; 1;1)1)1)1)1)1 
0) 1)2/3/4)5/6;7/8|9;/A/B/ CDI E|F)/O}1)2/3)/4)5)/6)7)8)9/A;ByC/DIE|F 


LKSH |I/S;L L| LOCK CRA RETURN LOCKWORD RPH 
D}T}O E}ADDRESS} LKACT | ADDRESS ADDRESS 
A|C V 
TIK E 
Ul oL 
S 


Byte (hex) Contents 
00-03 Record ID: C'LKSH' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
05 Indicates lock wait status: 
X'00' WAIT 
X'80' NOWAIT 
06-07 Level of lock to be obtained 
08—O0B Address of lock to be obtained 
OC—OF CRA lock account word (CRALKACT; see step 11 on page 79) 
10-13 Address of the issuer of the TPLOCK macro 
14—1B Lockword pointed to by address in bytes 08-0B 
1C-—1F Request parameter header (RPH) Address. 
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LNKx Entry 
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Entry: | LNKA, LNKB, LNKH, LNKI, LNKL, LNKV, or LNKX 
VIT Option: Clo 
Event: Change to link use count 


VIT Processing Module: ISTRACCI 
Control is Returned to: 
ISTTSCQA 


Applies to: 


This trace record is written when the link use count in the node control block (NCB) 


is incremented or decremented. 


O/O/O;O;HO;O;O;O/O;O/O;O;O;O;Oj;Oj;L;TpLi1pLidj~lpL{1pdjljiiajiji1y1 
0)1)2)3)4/5/6)7|8)9|A;BiC)DJE| FiO) 1)2)3)4)5)6)7/8/9)A}B/ CDI EF 


T}/R|E A} LINK j|NCB 
D| USE ADDRESS 
COUNT 


ISTPUCFL, ISTPUCGA, ISTTSCAF, ISTTSCDN, or 


Byte (hex) Contents 

00-02 Record ID: C'LNK' 

03 NCB type: 
C'LNKA' for AHNCB 
C'LNKB' for BSCNCB 
C'LNKH' for HALCB 
C'LNKI' for ICNCB 
C'LNKL' for LDNCB 
C'LNKV' for VLNCB 
C'LNKX' for XCNCB 

04 ID is one of the following: 


¢ Primary address space ID 

This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 


05 Reason for change to use count (DNPFUNC): 
X'01' Increment for boundary SLU element address (BLB) 
X'02' Increment for boundary PLU element address (BPAT) 
X'03' Increment for boundary SNA half-session (BSB) 
X'04' Increment for boundary non-SNA half-session (LUST) 
X'05' Increment for application half-session (FMCB) 
X'F1' Decrement for boundary SLU element address (BLB) 
X'F2' Decrement for boundary PLU element address (BPAT) 
X'F3' Decrement for boundary SNA half-session (BSB) 
X'F4' Decrement for boundary non-SNA half-session (LUST) 
X'F5' Decrement for application half-session (FMCB) 
X'F6' Decrement for line (NCB) 

06-07 Element address (for boundary element address reasons) 

08—0B Link use count after the increment or decrement 

OC—OF Node control block (NCB) address 
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10-13 Address of control block associated with the increment or decrement 
14-17 zero 


18-1B Module address or address of the issuer of the TSCDN caller 
1C-1F Zero. 
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LOST Entry for Lost Trace Record 


Entry: | LOST 

VIT Option: None 

Event: Lost trace record 

VIT Processing Module: ISTRACRR 

Control is Returned to: The location shown in register 14 
Applies to: 


This trace record indicates that the internal trace table is incomplete. Information 
from events that were supposed to be traced was lost because there were not 
enough save areas available for the tracing routine to record the information. 


O/O;O/O/O/O/O/O;O/O;O;O;O;O;O;O), Tj LiLiLiljilplplyljapijdj1jiiqyi 
0}1)2)3/4)5)6)17/8/9}A/BI CDE} F)0)1)2)/3)4)5)6)7)8)/9/A|B\C|DJE;F 
LOST es) REG 14 ‘LOST TRACE RECORD' 

D 


Byte (hex) Contents 
00-03 Record ID: C'LOST' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 
05-07 Zero 
08—OB Register 14 (return address) 
OC-1F C'LOST TRACE RECORD’. 
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LSNA Entry for Local SNA Record (Part 1) 


Entry: LSNA 

VIT Option: ClO 

Event: Read/Write from APPN PU Channel 
VIT Processing Module: ISTRACCI 

Control is Returned to: ISTTSC86 

Applies to: 


This trace record is written each time data is read or written across an APPN host- 
to-host channel. 


CHRCRECHACHECHECHACHECHRCHECHRCHECHICHECHECHE IPG POU G00 G0 G0 00000000 Guana Wan am 
0}1/2/3)4)5)6)7/8|9/A/BiC|DIE; F/O) 1)2)3)4)5)6)7)8)9;A/BiC| DEY F 


LSNA C}F)T| TSCB DAT); 18 BYTES OF LOCAL SNA DATA 
B}L|Y}ADDRESS}LEN 
T}A}P 
D|G|E 
S | 


Byte (hex) Contents 
00-03 Record ID: C'LSNA' 
04 ID-is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID 
e Task ID 


05 Control block ID of work element being written or read across the 
channel 

06 Event Flags 
Bit Meaning 
Lees wach The data unit being traced (FID2 data or contro] data) is 


the last data unit in the multipath channel (MPC) transmit 
block header just received. This bit only has meaning for 
inbound data. . 

-l.. .... This data is control data. If off, this data is normal FID2 
data traffic. 

..l1. .... | This trace entry contains the beginning of a new 
PlU/control data. If off, this data unit is the middle or end 
portion of a PIU. For outbound data, this bit will always 
be on (only the first part of PIU/Control data outbound is 
traced). 

07 A 1-byte field that indicates the direction of the data unit flow: 


Code Meaning 
C'l' Data received inbound 
C'O' Data sent outbound 


08—0B TSCB address 
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O0C-—0D Length of data being sent or received 
OE-—1F This 18-byte field will map as follows: 


e For control data 


— The 2-byte QLLC Header (indicating the type of the control 
data) 
— Up to 16 bytes of the remaining control data 


e For FID2 data 


— The 6-byte FID2 TH header 
— A 3-byte RH if it exists 
— Up to 9 bytes of the remaining FID2 data (12 bytes if no RH). 
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LSN2 Entry for Local SNA Record (Part 2) 


Entry: LSN2 

VIT Option: ClO 

Event: Read/Write from APPN Host PU Channel 

VIT Processing Module: ISTRACCI 

Applies to: 

This trace record is a continuation of the LSNA entry. It contains 28 more bytes of 
data. 


; 
F 


elalele olololololololalajaliajalalalalalajasasalala 
0} 1/213 gIAIBICIDIE/F/0/1/2/3/415/6/7 SI9IAIBICIDIE 


LSN2 28 MORE BYTES OF LOCAL SNA DATA 


Byte (hex) Contents 
00-03 Record ID: C'LSN2' 
04—1F Up to 28 more bytes of data. 
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MIC Entry for MVS IUCV Macro Completion 


Entry: MIC 
VIT Option: TCP 


Event: When a macro issued across the MVS-simulated IUCV 
| API completes 

VIT Processing Module: ISTRACIP 

Control is Returned to: ISTIPCII or ISTIPCIS 

Applies to: MVS 


This entry is issued when a macro that was issued to the MVS simulated IUCV 
interface completes. 


The trace record indicates which macro was issued and which IUCV path it was 
issued on. It also points to the parameter list used on the macro and shows the 


completion audit fields from the macro. 


4h te 46 a 
a te dt af pau 
| SOCKET RPH 
; MAJOR ADDRESS 
MIC 
BLOCK 
ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C'MIC' 


<= Oo & 
a >) 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
05 IUCV external interrupt type: 


X'01' Pending connection 

X'02' Connection complete 

X'03' Path has been severed 

X'04' Path has been quiesced 

X'05' Path has been resumed 

X'06' Priority message completion pending (REPLY) 
X'07' Non-priority message completion pending (REPLY) 
X'08' Priority message pending 

X'09' Non-priority message pending 


06 Return code from issuing the IUCVMINI SET macro. Otherwise, this 
field contains a zero. 

07. Zero 

08—0B Socket major control block address 

OC—OF lUCV IPARML parameter list address 

10-11 IUCV Path ID 


12-13 Audit flags or zero 
14-1B Zero 
1C-1F Request for parameter header (RPH) address. 
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MIE Entry for MVS IUCV External Interrupt 


Entry: MIE 
VIT Option: TCP 
Event: When MVS IUCV drives the external interrupt exit to 


signal the completion of an MVS IUCV macro 
VIT Processing Module: ISTRACIP 
Control is Returned to: ISTIPCIE 
Applies to: MVS 


This trace record is written when MVS IUCV drives the external interrupt exit to 
signal the completion of an MVS IUCV macro. 


The trace record copies the first 27 bytes of the external interrupt buffer. 


Olelelolololololololelolzlajalalajalajalalalalalafa}ila 
AISIGI7ISIOIAIBICIDIE/FIQ}1)213/41516/7/8/9/AIBIC|DIEJF 


FIRST 27 BYTES OF EXTERNAL INTERRUPT EXIT 


0/0 
2}3 


= 


0/0 
1 


MIE 


oO 


Byte (hex) Contents 

00-03 Record ID: C'MIE' 

04 ID is the primary address space !D (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05-—1F First 27 bytes of the External Interrupt Exit. 
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Mil Entry for IUCV API Call 


Entry: Mil 
VIT Option: TCP 
Event: IUCV API Call 


VIT Processing Module: ISTRACIP 
Control is Returned to: ISTIPCII! or ISTIPCIS 
Applies to: 


This trace record is written when a VTAM module issues an IUCV API call. 


The trace record indicates which macro is issued and which IUCV path it is issued 
on. It also points to the parameter list used on the macro and shows the return 
code from issuing the macro. 


ai HH He HAE ace 
Ae pace 


TUCV RPH 
ae PARM ADDRESS 
D CONTROL| LIST 

ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C'MIil' 


muo<- OnOr= 
moom 2ncHam w 
xrcaAaPYPvu =O Cre 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
05 Macro type: 


1 IUCVMINI SET 


2 IUCVMCOM CONNECT 

3 IUCVMCOM SEND 

4 IUCVMCOM SEVER 

5 IUCVMINI CLEAR 

6 IUCVMCOM SEVER(ALL) 
06 Return code from issuing macro 
07 Zero 
08—0B Socket major control block address 
OC—OF IUCV IPARML (ISTIPARM) address 
10-11 IUCV path ID (ISTMIPTH) 


12-1B Zero 
1C—-1F Request parameter header (RPH) Address. 
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MPT Entry for IP Component Read or Write (Part 1) 


Entry: 


VIT Option: 


Event: 


MPT 
TCP 
IP component reads in or writes out MPTN format 


VIT Processing Module: ISTRACIP 
Control is Returned to: Calling module (ISTIPCRP, ISTIPCWR, ISTIPCDR, or 


Applies to: 


ISTIPCDW) 


This trace record is written when an MPTN format is read in or written out by the IP 


component. 


Byte (hex) 
00—03 
04 


05 
06 


07 


08—0B 
OC—OF 


10-13 


14-1B 
1C-1F 
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HH EE meals HEME Neh 
le HH SHAE abe 


M 
P 
T 
N 
I 
i 


It contains information about the MPTN format being traced. 


NAM Y>rmrmn 


Contents 

Record ID: C'MPT' 

ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

Flag field (TSCFLAG1) 

MPTN format ID 

X'00' Header: No associated compensation 

X'01' Header: Expedited data 

X'03' Header: Expedited-data acknowledgement 

X'10' Header: Duplex-abortive termination 

X'20' Header: Segmented record 

X'80' MPTN connect 

X'82' MPTN datagram probe 

X'83' MPTN out-of-band datagram 

X'84' MPTN KEEPALIVE datagram 

If an MPTN command is being traced, the MTN_COMM_MIG_SPEC 
field is traced in this field. Otherwise, the field is zero. 

MPTN format length 

Address of transmission subsystem control block (TSCB) chain con- 
taining the MPTN format 

Return address of module issuing INTRACE 

Zero 

Request parameter header (RPH) address. 
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MPT2 Entry for IP Component Read or Write (Part 2) 


Entry: MPT2 

VIT Option: TCP 

Event: IP component reads in or writes out MPTN format 
VIT Processing Module: ISTRACIP 

Applies to: 


This trace record is a continuation of the MPT entry. 


O/O/OO;O;O/O;O/O;O;O; LIL Lp ApL(Lplpaydylylyplyapayqy. 
5}6/7/8)9/A|Bi/C|DJE} FiO; 1)2/3)4)5)6)7/8)9/A|BiC\|DIE|F 


28 BYTES OF THE MPTN FORMAT 


0|0)0 
2|3)4 


S 


4h 


0 
1}2)3 


MPT2 


Byte (hex) Contents 
00-03 Record ID: C'MPT2' 
05-1F 28 bytes of the MPTN format. 
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MSG Entry for Message Issued 


Entry: 


VIT Option: 


Event: 


MSG 
MSG 
Message issued (Part 1) 


VIT Processing Module: ISTRACOT 
Control is Returned to: ISTCFCTM 


Applies to: 


This trace record is written each time a message is issued by a VTAM module. 
You can use it to find the originator of a message and to see whether the message 
was solicited or unsolicited. 


MSG trace entries are generated for all messages, even those that are suppressed 
by message-flooding prevention (described in Appendix B, “Message Flooding 
Prevention” in VTAM Messages and Codes), by the MODIFY SUPP command 
(described in “MODIFY SUPP Command” in VTAM Operation), or by the SUPP 
start option (described in “SUPP” in the VTAM Resource Definition Reference). 
MSG trace entries thus provide information that may be missing from the operator’s 


console. 


The VTAM Internal Trace (VIT) does not trace the following messages: 


° Logon manager messages (beginning with ELM) 

. Sockets-over-SNA messages (beginning with ISU) 
e [QS TSO/VTAM messages (beginning with IKT) 

e VSCS messages (beginning with DTI). 


CHRCHRCHACHICRACHECHECHECHECHECHACHECHECHECHECI SDS C GU GU GU GR G0 0000000000 0 ana 
0} 1)2/3/4/5/6)7|/8/9)A)BiC|DJE; F/O) 1)2)3)4)5)6)7/8) 9) A|B\C| DIE} F 


MSG T}O}S|}MSG ID | MODULE DESTINATION 
D OR ID OR 0 
0 
r 
j : 


Byte (hex) Contents 


00-03 
04 


05 
06 


07—-0A 
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Record ID: C'MSG' 
ID is one of the following: 

¢ Primary address space ID 

This field is zero if the ID is greater than X'FF'. 

¢ Machine ID and Task ID 

e Task ID 
Zero 
‘S’ if the message was solicited (issued in response to a VTAM 
command); ‘U’ if the message was unsolicited 
Message ID or ‘USS’. If USS, the message ID appears in the variable 
text field in the MSG2 entry. If message ID, the 4-digit message 
number (or 3-digit message number and 1-character type code) 
appears in this field. 
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OB—OF 


10-13 
14-17 


18-1F 


MSG 


Issuing module ID (4th, 5th, 6th, 7th, and 8th characters of the issuing 
module name). See “Module Names in Internal Trace Records” on 
page 405 for information on determining the module name from the 
module ID. 

Save area address 

Address of the CPMSG macro | 

e If the high order bit in the return address field is on, CPMSG has 
been issued from a utility module. The module name and return 
address are that of the caller of the utility module. 

e If the high order bit in the return address field is off, CPMSG has 
not been issued from a utility module. The module name and 
return address are that of the module that issued the CPMSG. 

Destination 


e If byte 06 is S, this field contains one of the following: 
SYSTEMxx  xxis the ID of the system console. 


NLDM Message is destined for the session monitor compo- 
nent of the NetView program or NLDM. 


URC Message is to be sent to the system console using 
routing codes, instead of to one console in particular. 


POA Message is to be sent to a program operator appli- 
cation (POA) and the POA name is not available yet. 


e If byte 06 is U, this field is zero. 
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MSGS Entry for Message Sent (Part 1) 


Entry: MSGS 
VIT Option: MSG 
Event: Message sent (Part 1) 


VIT Processing Module: ISTRACOT 
Control is Returned to: ISTLUCRC or ISTMSCCN 


Applies to: 


This trace record is written each time VTAM sends a message to its destination. It 
can be used to correlate the console log with the internal trace. The destination 
may indicate that the message was sent to a system console (via a WTO macro) or 
to a program operator application, such as the NetView program (via a RCVCMD 
macro). 


O/O/O/O/O/O;/O;O;O;O/O;O;O/O;O;O; Li LiLpLiApApLiLpLiApijyljij1jij1 

0} 1/2)/3/4/5)6;7/8/9 ABI C(D/E}F) 0) 1/2/13) 4)5)6/7;8/9|A| Bi CDI E|F 

MSGS DESTINATION |MESSAGE;} FIRST 12 CHARACTERS 
HEADER OF MESSAGE TEXT 


Byte (hex) Contents 

00-03 Record ID: C'MSGS' 

04 ID is one of the following: 

¢ Primary address space ID 

This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 

05-07 Zero 

08—OF Destination. If ‘“SYSTEMxx’, the message was sent to system console 
‘xx’, via a WTO macro. If an application name, the message was sent 
to a program operator application, via a RCVCMD macro. 

10-13 Message header (in hex). If destination is ‘SYSTEMxx’, this will be the 
WPL header. If destination is a program operator application, this will 
be a program operator header (ISTDPOHD). 

14—1F First 12 characters of the message text. If the message text is longer 
than 12 characters, it will continue in the MSG2 entry. 
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MSG2 Entry for Message Sent (Part 2) 


Entry: MSG2 

VIT Option: MSG 

Event: Message issued or message sent (Part 2) 
VIT Processing Module: ISTRACOT 

Applies to: 


This trace record is a continuation of the MSG or MSGS trace record. It contains 
variable data for the MSG entry, or more message text for the MSGS entry. 


Up to two MSG2 entries can follow the MSG entry; however, only one MSG2 entry 
can follow the MSGS entry. 


0} 0;0/0/0;0;0;/0/0)0/0;0;/0/0/O/O)1) 1) 1) 1) 1) 2) 1) 1) 1) 2j2)1)1j1)1 
0) 1)2)3/4/5)6)7/8)9;A/BiC{D]E}F} 0) 1)2/3)4) 5/6) 7; 8/9) AB) CIDIE 


MSG2 VARIABLE DATA OR MORE MESSAGE TEXT 


0 1 
4 F 


Byte (hex) Contents 
00-03 Record ID: C'MSG2' 
04—1F Variable data, or more message text. 
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MU1 Entry for LU 6.2 Message Unit (Part 1) 


Entry: MU1 
VIT Option: APPC 
Event: , LU 6.2 message unit (Part 1) 


: 
N 
C 
D 


VIT Processing Module: ISTRACAC 
Control is Returned to: Module invoking the INTRACE macro that caused the 
Applies to: 
This trace record shows information about an LU 6.2 message unit. It is generated 
el dy alg rit ak 4H ah +P 4H a ar 
4 alg Hb a 4K 4 Ae ; “+ i: lp 
: MU ID|MU HALF |CORR AMU SENSE 
ADDRESS} SESS | VALUE FLAGS | DATA 
ID OR 0 
00-03 ~ Record ID: C'MU1' 
04 ID is one of the following: 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
05-07 Message unit ID 
X'010101' (END_CONVERSATION) 
X'010103' (FLUSH_DATA) 
X'010201' (PS_COPR_FMH5_RCVD) 
X'010302' (CONFIRMED) 
X'010303' (REQUEST_TO_SEND) 
X'010305' (SEND_ERROR) 
X'010306' (SEND_PACING_RSP) 
X'010501' (ALLOCATE_RCB) 
X'010502' (DEALLOCATE_RCB) 
X'010504' (UNBIND_PROTOCOL_ERROR) 
X'010505' (REJECT_SESSION) 
X'010507' (RESUME_SESSION) 
X'010701' (ATTACH_TP) 
X'020101' (CNOS_ABORT) 
X'020201' (CNOS_CLEANUP) 


record to be produced. 
whenever a message unit is queued to another component. 
Byte (hex) Contents 
e Primary address space ID 
e Task ID 
X'010102' (SESSION_FLOW_RESUMED) 
X'010301' (GSEND_EXPEDITED_DATA) 
X'010304' (SEND_DATA_RECORD) 
X'010307' (RSP_TO_EXPEDITED_DATA) 
X'010503' (GET_SESSION) 
X'010506' (SUSPEND_SESSION) 
X'010702' (END_XP) 
X'020501' (CNOS_COMPLETE) 
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X'020502' (CHANGE_SESSIONS) 
X'030101' (RECEIVE_EXPEDITED_DATA) 
X'030102' (CONFIRMED) 

X'030103' (REQUEST_TO_SEND) 
X'030104' (RECEIVE_DATA) 
X'030105' (RECEIVE_ERROR) 
X'030106' (PACING_RSP_RCVD) 
X'030107' (RSP_TO_REQUEST_TO_SEND) 
X'030108' (INITIAL_PACING_COUNT) 
X'030109' (DEALLOCATE_ABEND_REJECTED) 
X'030401' (ABORT_HS) 

X'030501' (ATTACH_ HEADER) 
X'030502' (FREE_SESSION) 
X'030503' (BID) 

X'030504' (BID_RSP) 

X'030505' (BIS_RQ) 

X'030506' (BIS_REPLY) 

X'030507' (RTR_RQ) 

X'030508' (RTR_RSP) 

X'030509' (SECURITY_HEADER) 
X'040101' (RESTORE_SESSION) 
X'040401' (LOAD_ PROFILES) 
X'040402' (RSP_LOAD_ PROFILES) 
X'040403' (DELETE_PROFILES) 
X'040501' (SESSION_ACTIVATED) 
X'040502' (SESSION_DEACTIVATED) 
X'040503' (ACTIVATE_SESSION_RSP) 
X'040504' (CTERM_DEACTIVATE_SESSION) 
X'040505' (LNS_LRM_FREE_AMU) 
X'050101' (RCB_ALLOCATED) 
X'050103' (SESSION_ALLOCATED) 
X'050104' (ATTACH_RECEIVED) 
X'050105' (CONVERSATION_FAILURE) 
X'050106' (SESSION_ REJECTED) 
X'050107' (SESSION_SUSPENDED) 
X'050108' (SESSION_RESUMED) 
X'050109' (RESUME_SESSION_FLOW) 
X'050301' (HS_PS_ CONNECTED) 
X'050302' (YIELD_SESSION) 
X'050303' (BID_WITHOUT_ATTACH) 
X'050304' (BID_RSP) 

X'050305' (BIS_RQ) 

X'050306' (BIS_REPLY) 

X'050307' (RTR_RQ) 

X'050308' (RTR_RSP) 

X'050309' (ENCIPHERED_RD2) 
X'050401' (ACTIVATE_SESSION) 
X'050402' (DEACTIVATE_SESSION) 
X'060201' (MODIFY_CNOS) 

X'060202' (MODIFY_DEFINE) 
X'060203' (DISPLAY_CNOS) 
X'060204' (DISPLAY_LUS) 

X'060205' (DISPLAY_MODES) 
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08-—0B 
OC—OF 
10-13 
14 — 

15-17 
18-1B 
1C-1F 
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X'060206' (DISPLAY_CONVS) 

X'060401' (MODIFY_PROFILES) 

X'070101' (TERMINATE_TP) 

X'070301' (SEND_1WAY_FASTPATH) 
Message unit address 

Half session ID 

Address of correlator value 

LU 6.2 message unit return code (AMURETCD) 
Zero , 
LU 6.2 message unit flags (AMUFLAGS) 

LU 6.2 message unit sense data (AMUSENSE) or zero. | 
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MU2 Entry for LU 6.2 Message Unit (Part 2) 


Entry: MU2 

VIT Option: APPC 

Event: LU 6.2 message unit (Part 2) 
VIT Processing Module: ISTRACAC 

Applies to: 


This trace record is a continuation of the MU 1 trace record. 
OOO/O/O/O/O/O/O/O;O/O;/OO;O/OsLIL{LILiLily1yLyUs Tl Lsi1siasisyaii1 
OILIZ13/4/5/6/7/BI9IAIBICIDIEIFIO;1/2/3/4;5/617/8/9/AIBIC/DIE]F 


MU2 SES|SES| CONV 
CNT}LIM! ID 
OR ;OR | OR O 
Q {0 


Byte (hex) Contents 
00-03 Record ID: C'MU2' 


ADDRESS|LENGTH | ADDRESS 


04 Zero 

05-07 Message unit ID shown in MU1 entry 
08—OB Data address or zero 

OC-—OF Data length or zero 

10-13 Resource allocation block address or zero 


14-15 For MU ID X'020502': Session count 
For all other MU IDs: Zero 

16-17 For MU ID X'020502': Session limit 
For all other MU IDs: Zero 

18-1B For MU IDs associated with an active conversation (X'010102', 
X'010201', X'010506', X'030108', X'050107', X'050109', 
X'050301'): Conversation ID 
For all other MU IDs: Zero 

1C-—1F Variable overlay field 


For MU ID X'020201': COPR control block address 


For MU ID X'020502': 
1C-1D Change in the CNOS value 
1E-1F Zero 


For MU IDs X'030106' and X'030108': Pacing count increment 


For MU IDs X'030501', X'030503', X'030504', and X'030507': 
RPH address for inbound half session 


For MU IDs X'040402' and X'040403': ACEE address 
For MU IDs X'010701' Address of the associated data for the MU. 
For all other MU IDs: Zero. 
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MUS3 Entry for LU 6.2 Message Unit (Part 3) 


Entry: MU3 

VIT Option: APPC 

Event: LU 6.2 message unit (Part 3) 
VIT Processing Module: ISTRACAC 

Applies to: 


This trace record is a continuation of the MU2 trace record. It is generated for only 
those message units which contain the following MU IDs: 


X'010102' X'040403' X'060202' 
X'010201' X'040501' X'060203' 
X'010501' X'050106' X'060204' 
X'010505' X'050107' X'060205' 
X'010506' X'050108' X'060206' 
X'020502' X'050109' X'060401' 
X'030509' X'050309' 
X'040401' X'050401' 
X'040402' X'060201' 


0/0/0)0;0)0)0/0)/0/0)0;0)0;0)/0)O)1) 1) 2) 1) 1) 1) 1) 1); 1) 1) 1) 1} 1) 1) 1741 

071/213) 4/516; 7/8 9 AIBIC DIE} FiO} 1)/2)3)4)5)6)7|8\9/AIB\C|DIE|F 

MU3 MU ID|MODE NAME OR LOCAL LU NAME |PARTNER LU NAME 
SESSION ID OR 0 


Byte (hex) Contents 
00-03 Record ID: C'MU3' 
04 Zero 
05-07 Message unit ID shown in the MU1 and MU2 entries 
08—OF Mode name for the following MU IDs: 
X'020502' | 
X'040501 ' 
X'050401 ' 
X'060202' 
X'060203' 


Mode name or zero for the following MU IDs: 
X'010501 ' 
X'060201 ' 
X'060205 ' 
X'060206' 


Session instance identifier for the following MU IDs: 
X'010102' 
X'010506' 
X'010507' 
X'050106' 
X'050107' 
X'050108' 
X'050109'! 
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Session instance identifier or zero for the following MU ID: 


X'010505' 
Zero for all other MU IDs 
10-17 Local logical unit name 
18—1F Partner logical unit name or zero; for X'060204', zero. 
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MU4 


MU4 Entry for LU 6.2 Message Unit (Part 4) 


Entry: MU4 

VIT Option: APPC 

Event: LU 6.2 message unit (Part 4) 
VIT Processing Module: ISTRACAC 

Applies to: 


This trace record is a continuation of the MUS trace record. It is generated for only 
those message units which contain the following MU IDs: 


X'010102' X'040403' X'060202' 
X'010201' X'040501' X'060203' 
X'010501' X'050106' X'060204' 
X'010505' X'050107' X'060205' 
X'010506' X'050108' X'060206' 
X'020502' X'050109' X'060401' 
X'030509' X'050309' 
X'040401' X'050401 ' 
X'040402' X'060201 ' 


1/1 
D\E|F 


0/0/0/0;0/0/0;0/0)0/0;0/0)0;0/0) 1) 1) 1) 1) 1) 1) 1) 1)1)1)1)1)1 
011)2)3)4)/5)6)7) 8/9) A|BIC|DIE|FJO)1)2)3)4)5)6)7)8)9;A\BIC 
MU4 PARTNER LU 

NETID OR 0 


Byte (hex) Contents 


aL 


00-03 Record ID: C'MU4' 
04-17 Zero | 
18—1F Partner network identifier or zero; for X'060204', zero. 
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NMPT Entry for an Exception Condition(Part 1) 


Entry: NMPT 
VIT Option: TCP 
Event: Negative MPTN format or duplex-abortive header is 


generated in response to an exception condition 

VIT Processing Module: ISTRACIP 

Control is Returned to: Module invoking the INTRACE macro that caused the 
record to be produced. 


Applies to: 


This trace record is written when a negative MPTN format or duplex-abortive 
header is generated in response to an exception condition. It contains information 
about the MPTN format being traced. 


This record is treated as an exception entry and is always traced regardless of the 
VIT options specified. 


O/O/O/O/O;O/O/O;O/O/O;O;O;O;O;O;LpLiLiL/ApAyLpA;yL~LpLpAy1yay1y1 
0)1/2)3/4)5/6)7/8/9/A|BIC|DJE}F)O)1)/2)3/4)5;6)7|8)9;A|BiC|DIE;F 


RETURN | PRIMARY|SECOND | RPH 
ADDRESS|RETURN ; RETURN |ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C'NMPT' 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05 — Flag field (TSCFLAG1) 

06 MPTN format ID 


X'10' Header: Duplex-abortive termination 
X'80' MPTN connect 
X'82' MPTN datagram probe 
X'83' MPTN out-of-band datagram 
X'84' MPTN KEEPALIVE datagram 
07 lf an MPTN command is being traced, the MTN_COMM_MIG_SPEC 
field is traced in this field. Otherwise, the field is zero. 
08—O0B MPTN format length 
OC-—OF If present, this field contains sense data from the UNBIND or negative 
BIND response. Otherwise, the field is zero. 
10-13 Return address of module issuing INTRACE 


14-17 If present, this field contains the primary return code from the diag- 
nostic vector. Otherwise, the field is zero. 
18-1B If present, this field contains the secondary return code from the diag- 


nostic vector. Otherwise, the field is zero. 
1C-1F Request parameter header (RPH) address. 
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NMP2 Entry for Exception Condition (Part 2) 


Entry: NMP2 
VIT Option: TCP 
Event: Negative MPTN format or duplex-abortive header is 


generated in response to an exception condition 
VIT Processing Module: ISTRACIP 
Applies to: MVS 


This trace record is a continuation of the NMPT entry and will contain the actual 


MPTN format. VTAM will generate as many NMP2 records as necessary to trace 
up to 868 bytes of the MPTN format. 


010/010 
a{1|2|3 


NMP2 


0|0 
4\5 


O/O;O;O;O;/O;O;O;O;O; Li) T)Aj;LiLj1j~liAj1j2jijij1j1)1 
61 7(8I9AIBICIDIE| FIO} 1j2)3) 4) 5; 6/7/89; AIBICI|DIE 


] 
F 


28 BYTES OF THE MPTN FORMAT 


Byte (hex) Contents 
~ 00-03 Record ID: C'NMP2' | 
04—1F 28 bytes of the MPTN format. 
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NRSP Entry for Negative Response to PIU Request (Part 1) 


Entry: NRSP 
VIT Option: PIU 
Event: Negative response to PIU request (Part 1) 


VIT Processing Module: ISTRACOT 
Control is Returned to: ISTTSCGR 


Applies to: 


This trace record is written when VTAM generates a negative response to a PIU 
request. Because this entry is associated with an event failure, it is treated as an 
exception condition and is always traced, regardless of the VIT options specified, if 
the VIT is active. 


4H SHAE 
4H 


NRSP |I/C\F{O| TSCB 20 BYTES OF PIU 
D}B)L| |ADDRESS 
IVA 
D|G 
S 


Byte (hex) Contents 
00-03 Record ID: C'NRSP' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 


05 Control block ID 
06 Flag field (TSCFLAG1) 
07 Zero 


08—0B Address of TSCB 
OC-—1F First 20 bytes of the PIU. 
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NRS2 Entry for Negative Response to PIU Request (Part 2) 


Entry: NRS2 

VIT Option: PIU 

Event: Negative response to PIU request (Part 2) 
VIT Processing Module: ISTRACOT 

Applies to: 


This trace record is a continuation of the NRSP entry. 


1} 1 


0/0/00 11/1 
0/1/2|3 9/A|B/C|D 
NRS2 24 MORE CHARACTERS OF THE PIU RETURN 
ADDRESS 


Byte (hex) Contents 

00—03 Record ID: C'NRS2' 

04-1B 24 more characters of the PIU 
1C-—1F Return address of the issuer. 
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NSD Entry for NSIND Exit 


Entry: NSD 

VIT Option: VCNS 

Event: NSIND exit scheduled 
VIT Processing Module: ISTRACNS 

Control is Returned to: ISTAPCUE 

Applies to: 


This trace record is written when the NSIND exit routine is scheduled. The exit is 
scheduled when VTAM receives a VCNSCMD CONTROL=LOGON request from a 
VCNS user. This trace record shows information about the exit invocation. 


OOOOH O/O/O/O/O/O;O/O/O;O;O; 1) 1; 1; 1)1j2jp1j1i2ypajljipijijiji 
0) 1/2)3/4)5/6/7/8/9/A/B/CIDIE;FiO;1)2)3)4)5/6)7;8;)9/ AB) CiD JE] F 


NETWORK EXIT STORAGE | ERROR 
ACCESS REASON |ADDRESS| INFO 
POINT 


Byte (hex) Contents 
00-03 Record ID: C'NSD' 
04 ID is one of the following: 
¢ Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID 
05-07 Zero 
08—0B Address of the ACB associated with the NSIND exit 
0C-13 Symbolic name of the network access point, defined with USER=VCNS 
in the packet major node or the interconnect major node, repres- 
enting a line to which the application program is logged on 
Symbolic name of the network access point, defined with USER=VCNS 
in the interconnect major node, representing a line to which the appli- 
cation program is logged on 
14-17 Reason the exit was scheduled: 
0 As a result of a network management-related event 
4 As a result of a termination of the VCNS line 
8 As a result of an error detected by VTAM which resulted in the 
termination of the LOGON request (for example, an abend) 
18-1B If exit reason in bytes 14-17 is zero, address of storage area con- 
taining specific error information about the exit event; otherwise, zero. 
1C-—1F If bytes 18-1B contain a storage area address, first 4 bytes of specific 
error information from the storage area. 
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OPER Entry for Operator Command (Part 1) 


Entry: OPER 
VIT Option: MSG 
Event: Operator command (Part 1) 


VIT Processing Module: ISTRACOT 
Control is Returned to: ISTLUCMD 
ISTCFF3D, ISTINCF9 


Applies to: 


This trace record is written each time a VTAM command is issued at the operator 
console. This can help you match the console log to a surge of activity shown in 
the VIT. This trace record is also useful when the console log is unavailable. Addi- 
tionally, it provides a record of POA commands that have been issued. These do 
not appear on the console log. 


The variable data in bytes 08—1F is the command text, with minor modifications. If 
this data is longer than 24 characters, it will continue in the OPE2 entry. The 
command always appears in abbreviated form: 


D DISPLAY command 
F MODIFY command 
V = VARY command 

Z HALT command 

9 


Unknown command passed to VTAM. 


NET and procname are excluded from the command text. Because the VTAM 
internal trace is not active when VTAM is started, the START command is not 
traced. 


alslels 
alt AB 4HHE 


ak FIRST 24 CHARACTERS OF OPERATOR COMMAND 
D 


Byte (hex) Contents 
00—03 Record ID: C'OPER' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 


05 Flag byte 
Bit Meaning 
Weis: evened A POA command was issued 
Owics ee Not a POA command 

06-07 Zero 

08-—1F First 24 characters of the operator command. 
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OPE2 Entry for Operator Command (Part 2) 


Entry: OPE2 

VIT Option: MSG 

Event: Operator command (Part 2) 
VIT Processing Module: ISTRACOT 

Applies to: | 


This trace record is a continuation of the OPER entry. 


CH RCHUCHECHACHACHACHACHECHECHECHACHECHECHACH ECU CURE GUG0 C000 000000000000 0m. 
0) 1/2)3;4(5/6) 7/89 ABC Di E;F{O/1)2)3)4/5)6; 7/8) 9;A;Bi Ci DIE 


OPE2 UP TO 28 MORE CHARACTERS OF THE OPERATOR COMMAND 


0 1 
4 F 


Byte (hex) Contents 
00-03 Record ID: C'OPE2' 
04—-1F Up to 28 more characters of the operator command. 
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PIC Entry for Packet Interface 


Entry: PIC 
VIT Option: Clo 
Event: Packet interface 


VIT Processing Module: ISTRACTR (SNAP trace recording routine) 
Control is Returned to: ISTTSC5F, ISTTSC5G 


Applies to: 


This trace record provides information about internal control flows of the telecom- 
munications subsystem or communication adapter. 


O;/O/O;O;O/O/O;O/O/O;O;/O;O;O;O;O; Li LiA;LiApLyL)aylydpajiyijijiyl 
0)1)2)3)}4)5}6}7)8)9)A|B)C}D)E|F)0}1)2)3)4)5|6)7)|8)9)A|BiC}D]E|F 
pice DATA 


Byte (hex) Contents 
00-02 Record ID: C'PIC' 
03—1F 29 bytes of PICB data. 
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PIU Entry (Part 1) 


Entry: PIU 
VIT Option: PIU 
Event: PIU record (Part 1) 


VIT Processing Module: ISTRACOT 

Control is Returned to: ISTLSC6V ISTTSCPR, ISTTSCLS, ISTTSCRI, 
ISTTSCSC, ISTTSCSR, ISTTSCWS, ISTTSCPD, 
ISTTSCLE, ISTTSCXS (or ISTINCF1 and INTINCS1 for 


RUPE) 
Applies to: 


This trace record provides information about external and internal FID4 PiUs. 


For most PIUs, only the first 48 bytes are traced (a 26-byte TH, a 3-byte RH, and 
the first 19 bytes of RU). However, certain classes of PIUs, such as session 
control RUs and VTAM RUs, are traced in their entirety. 


If the control block is a RUPE, the TH is reconstructed by the internal trace using 
what information is available. For TSCB entries, the PIU is recorded as is. 


If the PIU is a response with sense data, this entry will be generated whether the 
PIU option is in effect or not. It is treated as an exception condition and is always 
traced, regardless of the VIT options specified, if the VIT is active. 


0/0/0;0/0;0/0)0/0/0/0/0;0/)0)0;0) 2/1) 1) 1) 1) 172) 1) 1) 2)2)1)1)1)1)1 
0} 1)2)3)4)5/6)7)8{9|A/BiC|DIE|F/O/1)2)3)4)5)6)7|8\9/A)B\C\DIE|F 


"hee 20 BYTES OF PIU 


Byte (hex) Contents 
00-03 Record ID: C'PIU' 
04 ID is one of the following: - 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 


OND Yr 


05 Control block ID: X'54'=RUPE, X'99'=TSCB 
06 Flags (TSCFLAG1) or zero if control block is a RUPE 
07 Zero 


08—0B TSCB or RUPE address (see byte 5) 
OC-—1F Twenty bytes of PIU. 
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PiU2 Entry (Part 2) 


Entry: PIU2 

VIT Option: PIU 

Event: PIU record (Part 2) 

VIT Processing Module: ISTRACOT 

Applies to: 

This trace record is a continuation of the PIU entry and contains 28 more bytes of 
FID4 PIU. 7 


The VTAM internal trace will generate as many as 31 PIU2 records in the following 
situations: 


e For PlUs that are formatted and contain session control RUs 
e For RUs to or from the SSCP or PUs 
e When the VIT LCS option was specified and the PIU contains LCS data. 


The number of records generated depends on the data count field in the TH. 
0/0 O1O/O/O/O/O;O;O;O/O;O;O;1) 1) 1) 1) LiLpLy1piplylpayiy.zyqyl 
Q}1 4)5)6|7|/8/9)A)BiC{/D/E}F)0;1)2)3)4/516)7/8)9)A|BiCID/E|F 
PIU2 28 MORE BYTES OF PIU 


Byte (hex) Contents 
00-03 Record ID: C'PIU2' 
04—1F Up to 28 more bytes of the FID4 PIU (padded at right with zeros). 


0/0 
2\3 
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PKTI or PKTO Entry for X.25 Packet Sent or Received (Part 1) 


Entry: PKTI or PKTO 
VIT Option: ClO 
Event: X.25 packet sent or received (Part 1) 


VIT Processing Module: ISTRACTR (SNAP trace recording routine) 
Control is Returned to: ISTTSC5B 


Applies to: 


This trace entry provides information about packets received at (PKTI) or sent from 
(PKTO) an X.25 port. 


A PKTI trace record is written whenever the buffer control channel program com- 
pletes with packets received. 


A PKTO trace record is written whenever a packet is transferred to the telecommu- 
nications subsystem or communication adapter by inserting it into the buffer control 
channel program. 


Note: If the packet is longer than 20 bytes (including the packet header), up to 27 
additional bytes of data are contained in the PKTX trace record. 


AH aE 
alala ABE 


a i FIRST 20 BYTES OF THE PACKET 
PKTO | 


Byte (hex) Contents 

00-03 Record ID: 
C'PKTI' for inbound packet 
C'PKTO' for outbound packet 


04 ID is one of the following: 
Machine ID and Task ID 
Task ID 
05-07 Channel device name in EBCDIC (either a CUA or device number) 
08 Packet finite state machine (PFSM) 
09 Index to slot that packet arrived on 


OA-O0B Packet length 
0C-—1F First 20 bytes of the packet. 
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PKTX Entry for X.25 Packet Sent or Received (Part 2) 


Entry: PKTX 
VIT Option: ClO 
Event: X.25 packet sent or received (Part 2) 


VIT Processing Module: ISTRACTR (SNAP trace recording routine) 
Control is Returned to: ISTTSC5B 


Applies to: 


This trace record is a continuation of the PKTI or PKTO trace record. 


lelolololelelololeljelololejelololzjajalalalalalaialalalalalasata 
Ol1121Z14/S5/6I7ISISIAIBICIDIEIFIO/1/2/3/4/5/6/7/819|AIBICIDIE|F 
PKTX ; ADDITIONAL BYTES OF PACKET 


Byte (hex) Contents 
00-03 Record ID: C'PKTX' 
04 ID is one of the following: 
° Machine ID and Task ID 
e [Sa Task ID 
05-—1F Up to 27 additional bytes of the packet. 
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POST Entry for Post Waiting Event 


Entry: POST 
VIT Option: PSS 
Event: Post waiting event 


VIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCTP 


Applies to: 


This trace record identifies an RPH that is being posted (via the TPPOST macro) 
for restart after a TPWAIT macro. Usually the POST entry is followed sometime 
later by a RESM entry. However, when a TPPOST precedes the TPWAIT, the 
TPWAIT returns to the caller immediately without waiting. Then POST is not fol- 
lowed by RESM. 


AMEE He 4HAb “ARE sly lala ARH 
alt ME nelele HH alalals ARAE HEE 


POST PST PAB RETURN | WORK DVT RPH 
ADDRESS | ADDRESS | ADDRESS | ELEMENT | ADDRESS | ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C'POST' 
04 ID is one of the following: 
¢ Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
05 Zero 
06—07 PAB offset 
08-OB — PST address 
OC-—OF PAB address 
10-13 Address of the issuer of the TPPOST macro 
14-17 Work element address (from RPHWEA) 
18-1B PAB DVT address 
1C-—1F Address of the RPH being posted. 


A 
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PROA or PROD Entry for Profile Add or Delete 


Entry: PROA or PROD 

VIT Option: NRM 

Event: Profile Add or Delete 
VIT Processing Module: ISTRACNR 

Control is Returned to: ISTSDCPM 

Applies to: 


This trace record give information about PROFILE macroinstruction processing. It 
is written when a VTAM module issues a PROFILE macroinstruction to add or 
delete an RDTE profile. 


O/O;/O;O/O/O;O;O/O/O;O/O/O/O/O;O) 1) 1; 1;1pApLpA;A;Afa; 1p Ap ly1}qi1 
0) 1)2)3)4/5/6)7/8|9{|A/ByC{|DIE} F/O; 1)/2/3/4)5)6)7)8)/9;A;BiC| DIE] F 


PROA j|I] KEY OUTPUT |RETURN | RDTE RESOURCE NAME 
PROD |D) INDEX| PROFILE} PROFILE} ADDRESS | ADDRESS 
or 0}ADDRESS| ADDRESS 


Byte (hex) Contents 
00—03 Record ID: 
e C'PROA': Add a profile 
e C'PROD': Delete a profile 
04 ID is one of the following: 
| e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 
05-07 Key index into the RDTE profile table or 0. Note that an index value of 
0 is valid and represents the first slot in the profile table. The index 
might also be 0 for PROA entries created when a profile is first associ- 
ated with an RDTE during SYSDEF processing. | 
08—OB Input profile address 
OC—OF Output profile address | 
10-13 Return address of the module calling the ISTSDCRP module or the 
address of the module issuing PROFILE macro 
14-17 RDTE address 
18—1F Resource name. 
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QREQ Entry for Queued REQSTORE 


Entry: QREQ 
VIT Option: SMS 
Event: Queued storage request 


VIT Processing Module: ISTRACSM 
Control is Returned to: ISTORFBQ 


Applies to: 


This trace record identifies a REQSTORE request that was waiting for one or more 
buffers, and which is now satisfied. 


CPRCHRCHACHACHECHACHECHACHECHECHECHRCHECHECHECI PGR GUO GCP GU GR GUGPGRGRGRGR Onan 
0} 1)2)3/4/5)6/7/8/9/A)BIC|DJE; F/O) 1)2)3)4)5)6|7|8|/9;|A/B/C)D|E|F 


QREQ C PST BUFFER NUM RPH 
B ADDRESS | ADDRESS BUF ADDRESS 
I REQ 
D 


Byte (hex) Contents 
00-03 Record ID: C'QREQ' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
05 Control block ID index value 
06-07 Zero 
08—0B PST address 
OC-—OF Address of buffer obtained 
10-13 Zero 
14-15 Number of buffers requested 
16-1B Zero 
1C-1F Request parameter header (RPH) Address. 
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QRYL Entry for Query Language 


Entry: QRYL 
VIT Option: MSG 
Event: Query language error 


VIT Processing Module: ISTRACOT 
Control is Returned to: ISTINCUL 
Applies to: MVS 


This trace record is generated when a non-zero return code is received from the 
QRYLANG macro. When the return code and reason code indicate that the MVS 
message service is not active, no QRYL trace record is generated. 


OOMCHRCRACH ACH ACH ACH ACHRCH ACH ACH ACHECHOCHECH ACEI UG 0 0) 00) 0) il 0 ai gm 
0} 1)2/3/4/5/6)/7/8/9;A/BIC|/DJE} F/O; 1,2)3)4)5)6/7/8/9;A}B)C| DIE} F 


QRYL RETURN |REASON |FIRST 8 BYTES 
CODE CODE OF LANGUAGE 
NAME USED IN 
ADDRESS | LENGTH QUERY 


Byte (hex) Contents 

00—03 Record ID: C'QRYL' 

04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05-07 Zero 

08—OB Language query block address 

OC-—OF Language query block length (LQBSIZE) 

10-13 Return code 

14-17 Reason code 

18—1F First 8 bytes of language name used in query (LQBINLNG). 
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QUE Entry for Work Element Queued to PAB 


Entry: QUE 
VIT Option: PSS 
Event: Work element queued to PAB 


VIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCTQ 


Applies to: ) 


This trace record shows a work element queued to a PAB to allow another VTAM 
routine to do further processing with the work element. This entry may be followed _ 
shortly by a DSP entry, representing the PSS dispatch of this PAB. However, if the 
PAB is already running, it might not be dispatched again. In this case, no DSP 
entry follows the TPQUE. 


ABBE HE Bela tHE HERE ARE te 
alee led ala RE ou 


PST PAB RETURN |WORK 
ADDRESS | ADDRESS | ADDRESS | ELEMENT | NAME 


Byte (hex) Contents 
00-02 Record ID: C'QUE' 


: 


03 Control block ID of work element (see Appendix H, “Storage and 
Control Block ID Codes” on page 1137) 
04 ID is one of the following: 


e Primary address space ID 

This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 


05 Status 

Bit Meaning 

RNG “ag Type of scheduling request 
Bit Meaning 
00 TPQUE none 
01 TPQUE normal 
10 TPQUE delay 

ike cence ~ZOLO 

.-l1 .... Queue is in last-in-first-out (LIFO) order. 


.».. Queue is in first-in-first-out (FIFO) order. 
. 1... Registers are saved in the RPH control block. 
X.. Zero 


.... «1. PAB work element queue gate bit (PABWEQG). 

sea Utes © PAB change bit (PABCHNG). PAB is not scheduled to 
run. 

weleie aie 1. PAB is scheduled to run. 
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QUE 


06 


07 


08—0B 
OC-—OF 
10-13 
14-17 
18-1B 


1C-1F 
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PAB flag field (PABFLAGS) 


Bit | Meaning 
Dees ae PAB is unconditionally scheduled. 
.1.. .... | PAB closedown is in progress. 
..l. .... | PAB is synchronous. 
..-l .... | PAB extension is present. 
. 1... Do not dequeue work element. 


.1.. Do not detach the RPH. 
..1. Indicates a very extended PAB. 


sae: sacar 1 Indicates a slightly extended PAB. 

PAB flag field (PABFLGS1) 

Bit Meaning 

Lise Saar Switch the PST address of this PAB’s major control block 


to the new PST address contained in DYPNWPST. 
-1.. .... | This PAB has a data space extension. 
..l. .... | This PAB’s major control block is an FMCB. 
..l1 .... PAB can be referenced in PSW disable mode. 
. 1... PAB is persistent. 
1... APSTERM/APSINIT FMCB during PAB dispatch. 
sews ate xx Reserved. 
PST address 
PAB address | 
Address of the issuer of the TPQUE macro 
Address of work element to be queued 
Module name abbreviation (bytes 4, 5, 7, and 8 of the module name), 
PAB DVT address (high order bit of X'18' = 0), or one of the following 
abbreviations, which may represent a function or process. The module 
name might be unavailable if the PAB being scheduled is associated 
with an address space different from the current one. 
Abbreviation Meaning 


CPSS APPN session services for CP-CP sessions 

DSVC Directory services 

DIO Disk I/O 

LUSS APPN session services for LU-LU sessions 

MST Management services and session initiation and termi- 
nation 

TRS Topology and routing services 


Request parameter header (RPH) Address or zero. 
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QUEN Entry for Work Element Queued to Any Control Block 


Entry: QUEN 
VIT Option: PSS 
Event: Work element queued to any control block 


VIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCTQ 


Applies to: 


This trace record shows a work element queued to any control block (not just a 
PAB) to allow another VTAM routine to further process the work element. 


ie tHe Plats ls lala AEHE THEE 
HHH HH HE elas HAE HHHE pach 


Tc 
D 


Byte (hex) Contents 
00—03 Record ID: C'QUEN' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
05 Control block ID of work element (see Appendix H, “Storage and 
Control Block ID Codes” on page 1137) 
06-07 Zero 
08—0B Address of PST or zero 


OC—OF Address of the contro! block field to which the work element is queued 
10-13 Address of the issuer of the TRQUE NONE macro 
14-17 Address of work element to be queued 


18-1B Zero 
1C—1F Request parameter header (RPH) Address or zero. 
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RACR Entry for LU 6.2 Invocation of RACROUTE 


Entry: RACR 
VIT Option: APPC 
Event: Resource access control 


VIT Processing Module: ISTRACAC 
Control is Returned to: ISTNSCSI 


Applies to: 


This trace record shows information about the completion of a RACROUTE macro. 
This trace record is written during security processing for session establishment. 


O/O;O/O/O/O/O/O/O;O;O/O/O;O;O;O; 1; 1) T;LiAjLj;1p1paydsy1p1piyiyay1 
0}1)2)3/4)5/6)7/8)9)A|B/C|D}E} F/O) 1)2)3)4)/5)6)7)8)9;A;/BIC}DIE|F 


RACR T}O;ACEE HALF REQUEST | REQUEST 
Y} |ADDRESS|SESS COMPLET}RETURN | REASON 
e ID 
E 


Byte (hex) Contents 
00-03 Record ID: C'RACR' 
04 ID is one of the following: 
e Primary address space ID [J 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 


05 RACROUTE request 
X'01' AUDIT 
X'02' EXTRACT 
X'03' LIST 
X'04' VERIFY 

06 RACROUTE type 


For AUDIT: Zero 

For EXTRACT, LIST, or VERIFY: 
X'01' CREATE 

X'02' DELETE 

X'03' ENCRYPT 

X'04' EXTRACT 


O07 Zero 
08—0B Address control environment element (ACEE) address 
OC—OF Half-session ID 

- 10-13 Zero 


14-17 RACROUTE completion code 
X'00' Request successfully completed 
X'04' Request completed with non-zero return/reason code 
X'08' RACROUTE failure 
18-1B Request return code from security management product® 
1C—1F Request reason code from security management product®. 


8 See the appropriate manual for your security management product for an explanation of the return/reason codes. 
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RCEx Entry for RCE Macro 


Entry: RCEA, RCEC, RCED, or RCEF 
VIT Option: NRM 
Event: RCE macro 


VIT Processing Module: ISTRACNR 
Control is Returned to: ISTRACSC 


Applies to: 


This trace record contains information about an RCEADD, RCECHG, RCEDEL, or 
RCEFIND macroinstruction issued by a VTAM module. 


O}O/O/O/O/O/O/O/O/O/O;O;O;O;O;O/ 1) 1; 1p 1p 2jp2p1plpljljijijijijij1 
0} 1)2/3)4)5)6/7/8/9/A;BiC|DJE} FiO) 1),2)3)4)5)6)7)/8/9|A|Bi CDi E;F 


I}R} TIM KEY VALUE RETURN |OUT1 OR|OUT2 OR|DATA 
ADDRESS | NEW 


Byte (hex) Contents 
00-03 Record ID: C'RCEA' (RCEADD), C'RCEC' (RCECHG), C'RCED' 
(RCEDEL), C'RCEF' (RCEFIND) 

04 ID is one of the following: 

e Primary address space ID 

This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 


moO © 


05 Return code 
06 Type of RCE entry 
07 Mode of RCE entry (in hex) 


-@ 0Q1=Base entity mode 
e 02=Reference entity mode 


08—OF Key value (base entity name, base index, or reference index, 
depending on mode) 
10-13 Address of the issuer of the macro 


14-17 For RCEADD, RCEDEL, and RCEFIND: Value in RCEPOUT1 
For RCECHG: First half of new table name 

18-1B For RCEADD, RCEDEL, and RCEFIND: Value in RCEPOUT2 
For RCECHG: Second half of new table name 

1C—1F Data address. 
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RDSC Entry for RUPE Discard (Part 1) 


Entry: RDSC 
VIT Option: PIU 
Event: Discarding a RUPE 


VIT Processing Module: ISTRACOT 
Control is Returned to: ISTDLCDI 


Applies to: 


This trace record is written when VTAM's dependent LU server receives an erro- 
neous signal either from the VTAM configuration services component or from the 
dependent LU requester node across the CPSVRMGR session. 


0/0)0/0/0/0/0/0/0/O/O/O/O/O/O;O) 1) 1; LjpLylplplpliljdjijijijijqyl 
0} 1)2)3)4)5/6|/7/8/9/A;/B/C;|D/E}F}O)1)2)3;4)5/6/7|/8/9/AIB/C)DIE|F 


‘| RDSC {I} RC | RUPE FIRST 20 BYTES OF PIU DATA 
D} E O |ADDRESS 
D 
E | 


Byte (hex) Contents 
00-03 Record ID: C'RDSC' 
04 ID is one of the following: 

e Primary address space ID 

This field is zero if the ID is greater than X'FF'. 

e Machine ID and Task ID 

e Task ID 
05-07 Reason code (decimal) 

1 The dependent LU server abend recovery routine, DLCRR, per- 

forms clean-up. 

2 CV X'60' is not found. 

3 Dependent LU requester element is not found. 

4 PU element is not found. 
5 LU element is not found. 
6 
7 
8 


=_On Y> 


Storage shortage has occurred. 
Dependent LU requester finite state machine is not valid. 
Dependent LU requester finite state machine is pending inactive. 
9 CPSVRMGR session pipe activation failure has occurred. 
10 Unrecognized request unit processing element (RUPE) detected. 
11. Start transaction program (STARTTP) failure has occurred. 
12 CPSVRMGR session pipe has already been deactivated. 
13 PU finite state machine is not valid. 
14. SEND_ENCAP_TP process anchor block (PNB) does not exist. 
08—0B Address of the RUPE being discarded 
O0C-—1F First 20 bytes of PIU data (inbound) or RUPE's RU data (outbound) in 
the RUPE being discarded. 


768 = VTAM V4R2 Diagnosis | LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” RDS2 
Licensed Materials — Property of IBM 


RDS2 Entry for RUPE Discard (Part 2) 


Entry: RDS2 

VIT Option: PIU 

Event: Discarding a RUPE 
VIT Processing Module: ISTRACOT 
Applies to: 


This trace record is a continuation of the RDSC entry. 


0)O/O/O)O/O/O/O/O/O/O;O;O;O/Oj;O, 1) 1) 1) 1) 1; 1) 1; 171; 1; ayl 
0)1)2)3)4)5/6)/7/8)9/A/BIC/DIE| FiO) 1)2)3)4)5|6)7/8/9;A\B 
R A 


RDS2 NEXT 20 BYTES OF PIU DATA 


1j1}1)1 
C)DiE|F 


Byte (hex) Contents 

00-03 Record ID: C'RDS2' 

04-17 Bytes 21 through 40 of the PIU data (inbound) or RUPE's RU data 
(outbound) in the RUPE being discarded 

18-1B Return address 

1C—1F The module name that initiates the RUPE discard. 
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RE Entry for RPL Exit 


Entry: RE 
VIT Option: API 
Event: RPL exit 


VIT Processing Module: ISTRACAP 
Control is Returned to: ISTAPCSX, ISTAPCUE, or ISTAICPT 


Applies to: 


This trace record contains RPL information passed from VTAM to the application 
program. lf the return code or feedback is non-zero, this entry will be generated 
whether the API option is in effect or not. It is treated as an exception condition 
and is always traced, regardless of the VIT options specified, if the VIT is active. 


See “RPL-Based Macroinstruction Errors and Special Conditions” in VTAM Pro- 
gramming for a description of RPL return codes. 


OOOO O/O;O/O;O;O/O/O/O/O;Os;O;Ti1;Li1j1jp1jApAp1p~1y1pijijij1y1 
0) 1)2/3)4/5/6)7/8/9/A}B/C)D)E} F/O) 1)2)3)4)5)6) 7) 8) 9; A; B/C} D) EF 


RIE} TR] FI F RPL EXIT RPL RPL CID RPL 
D|D| ADDRESS |ADDRESS| AREA RLEN OR 0 FDBK2 
B/B 
2\3 


Byte (hex) Contents 
00-02 Record ID: C'RE' 
03 RPL request type (RPLREQ) 
X'15' SETLOGON 
X'16' SIMLOGON 
X'17' OPNDST 
X'19' CHANGE 
X'1A' INQUIRE 
X'1B' INTRPRET 
X'1F' CLSDST 
X'22' SEND 
X'23' RECEIVE 
X'24' RESETSR 
X'25' SESSIONC 
X'27' SENDCMD 
X'28' RCVCMD 
X'29' REQSESS 
X'2A' OPNSEC 
X'2C' TERMSESS 
03 Exit definition (RPLEXTDS) 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 
05 Return code (RPLRTNCD) (See “RPL-Based Macroinstruction Errors 
and Special Conditions” in VTAM Programming) 


<o4oOm 
ONO oH x< 
IO Zo 
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06 


07 


08-0B 
OC-OF 
10-13 
14-17 
18-1B 
1C-1F 


RE 


Feedback code (RPLFDB2) (See “RPL-Based Macroinstruction Errors 
and Special Conditions” in VTAM Programming) 

Feedback data flag (RPLFDB3) (See “RPL-Based Macroinstruction 
Errors and Special Conditions” in VTAM Programming, under INQUIRE 
macro with OPTCD=APPSTAT) 

RPL address 

Exit address 

RPL data area pointer (RPLAREA) 

Record length (RPLRLEN) 

CID from NIB or from RPL (RPLARG) or zero 

Second RPL feedback area - Sense code (RPLFDBK2). 
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RELS Entry for Release Storage 


Entry: RELS 
VIT Option: SMS 
Event: Release storage 


VIT Processing Module: ISTRACSM 

Control is Returned to: ISTORMBD 
ISTORFBD 
ISTORCRT 


Applies to: 


This trace record provides the status of each RELSTORE request issued by VTAM 
components to release fixed-length buffers to one of the predefined buffer pools. 


RELSTORE is the complement of REQSTORE. Storage obtained by REQSTORE 
must be released by RELSTORE. However, because more than one buffer can be 
obtained and released at a time, there may not be a RELS for every REQS, and 
there may not be a REQS for each RELS. Use the “next buffer address” in RELS 
and the “number of buffers” in REQS to help determine the correlation between 
buffers requested and buffers released. 


Ab a He aHHe ABE AHHE HHP 
slats HHH 4Hhe ABHE AHRE HAE 


RELS He R} PST 


Byte (hex) Contents 
00-03 Record ID: C'RELS' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
05 Control block ID index value or zero. A zero is returned if 
the buffer is not allocated for a specific control block. 


For the index values and the control block IDs they represent, see 
VTAM Data Areas for MVS/ESA or VTAM Data Areas for VW/ESA. 
First character of buffer pool ID 

06 Zero 
Last character of buffer pool ID. See “SMS Trace Record Output 
(VSE)” on page 379 for a listing of the 2-character values. 

07 Return code 

08—O0B PST address | 

OC-—OF Address of buffer to be released 

10-13 Address of the issuer of the RELSTORE macro 

14-17 Pointer to the next buffer to be released if more than one buffer to be 
released; otherwise, zero 

18-1B Register 1 (normally RPH address) 
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1C-1F Caller of utility routine, or zero 


Address of the utility's caller if the RELSTORE macro was issued 
from a utility routine; otherwise, zero if the macro was issued directly 
by the caller without a utility routine (See bytes 10-13 for the address 
of the issuer of the RELSTORE macro). 


Zero. 
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REQS Entry for Request Storage (Part 1) 


Entry: REQS _ 
VIT Option: SMS 
Event: Request storage (Part 1) 


VIT Processing Module: ISTRACSM 

Control is Returned to: ISTORMBA 
ISTORFBA 
ISTORCRQ 


Applies to: 


This trace record provides the status of each REQSTORE request issued by VTAM 
components to obtain fixed-length buffers from one of the predefined buffer pools. 
The storage obtained by REQSTORE is released by RELSTORE. 


If this entry is associated with an event failure (that is, the return code is non-zero), 
this entry will be generated whether the SMS option is in effect or not. It is treated 

as an exception condition and is always traced, regardless of the VIT options speci- 
fied, if the VIT is active. 


0/0)0)0)0 o/ojo/o/o/ojolojolojzj1jafajafajafajafafalajafafala 
0/1)2)3)4)/5)6)7/8/9jA|B/C|DIE} F/O, 1)2)3/4)5)6)7)8)9;A|B)C|DJE|F 


BUFFER |} RETURN | NUM REG 1 |RETURN 
ADDRESS | ADDRESS | ADDRESS | BUF CODE 
REQ 


Byte (hex) Contents 
00-03 Record ID: C'REQS' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
05 Control block ID index value or zero. A zero is returned if 
the buffer is not allocated for a specific control block or if the buffer 
allocation failed. | 


For the index values and the control block IDs they represent, see 
VTAM Data Areas for MVS/ESA or VTAM Data Areas for VM/ESA. 
First character of buffer pool ID 

06-07 Zero 
Last character of buffer pool ID See “SMS Trace Record Output 
(VSE)” on page 379 for a listing of the 2-character values. 

08—0B Pointer to the PST, or zero 


OC-OF Address of buffer obtained, or zero if buffer not obtained 
10-13 Address of the issuer of the REQSTORE macro 
14-15 Number of buffers requested 


16-17 Zero 
18-1B Register 1 (normally RPH address) 
1C-1F Return code 
00 Successful. 
04 Storage obtained, but slowdown threshold exceeded. 
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06 Storage request queued, but buffer pool has to be 
expanded before buffers can be allocated. 
08 The number of buffers requested could not be allocated 


immediately. Depending on the conditions specified on the 
REQSTORE request and the state of the buffer pool that is 
requested, the request may or may not be queued for 
future processing. 


The request is queued for future processing if one of the 
following sets of conditions is met: 


e The REQSTORE request specifies that it can be 
queued for future processing regardless of the state of 
the buffer pool from which buffers are requested. 


e The REQSTORE request specifies that it can be 
queued for future processing if specific conditions are 
met. These conditions are as follows: 


— Number of buffers already allocated plus the 
number of buffers for which there are outstanding 
requests does not exceed the maximum size of the 
buffer pool. 


— Buffer pool is defined to be expandable. 


— Buffer pool expansion has never failed for the 
buffer pool or the buffer pool has contracted since 
it failed to expand. 


The request is not queued for future processing if any of 
the following conditions apply: 


e The REQSTORE request specifies that it is not to be 
queued under any circumstances. 


e The REQSTORE request specifies that it is to be 
queued according to one or more of the conditions 
described previously and the specified conditions are 
not met. 


16 This return code applies only to non-expandable buffer 
pools. The number of buffers requested exceeds the 
maximum number which can be allocated in one request. 
This return code does not indicate that the number of 
buffers requested is not available; it indicates that the 
number of buffers exceeds the maximum allowed in one 
request. 
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REQ2 Entry for Request Storage (Part 2) 


Entry: REQ2 

VIT Option: SMS 

Event: Request storage (Part 2) 
VIT Processing Module: ISTRACSM 

Applies to: 


This trace record is a continuation of the REQS entry. It is generated when 
REQSTORE macro was issued for more than one buffer. ‘The number of records 
generated depends on the number of buffers obtained by the REQSTORE request. 


VTAM generates up to 31 REQ2 trace records. Each REQ2 entry contains 
addresses for up to 7 buffers. If more than 218 buffers are requested, the last four 
bytes, 1C—1F, in the last REQ2 entry is set to X'FFFF' indicating that not all of the 
requested buffers are traced. 


CRRCHRCHECHECHECHECHACHACHECHECHECHDCHECHECHECL PGR GUGU G0 000000000 0000000000000 
0}1)2)31)4)5/6)7/8/9 A; BiC|DIE| F/O} 1)2)3/4)5)6; 7,8, 9;A; B,C] DE] F 
REQ2 7 WORDS OF BUFFER ADDRESSES 


Byte (hex) Contents 

00-03 Record ID: C'REQ2' 

04-1F Up to 7 more words of buffer addresses (padded on the right with 
zeros). 
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RESM Entry for Resume Event Processing 


Entry: RESM 
VIT Option: PSS 
Event: Resume event processing 


VIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCPD 


Applies to: 


This trace record gives information about which VTAM process is about to be redis- 
patched after a TPWAIT. A RESM entry follows a POST, although not every POST 
has a RESM. Usually the POST entry is followed sometime later by a RESM entry. 
However, when a TPPOST precedes the TPWAIT, the TPWAIT returns to the caller 
immediately without waiting. Then POST is not followed by RESM. Use the RPH 
address to find the original DSP entry, which may have occurred quite some time 
earlier. 


HEE {Hiab HAE SHE wBAe ‘elelo 
alt HEE Hib HAE AHHe HAE Nelelo 


PST PAB WORK EL} WORK RPH 
ADDRESS | ADDRESS} ADDR or} ELEMENT | DVT 
A 
G 
S 


Byte (hex) Contents 
00—03 Record ID: C'RESM' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 


05 Control block ID of work element (see Appendix H, “Storage and 
Control Block ID Codes” on page 1137) 
06 PAB flag field (PABFLAGS) 
Bit Meaning 
dost ceranene PAB is unconditionally scheduled. 
.l.. .... | PAB closedown is in progress. 
-.l. .... | PAB is synchronous. 
..1 .... PAB extension is present. 
. 1... Do not dequeue work element. 


.1.. Do not detach the RPH. 
.... ..l. Indicates a very extended PAB. 
aa, wie 1 Indicates a slightly extended PAB. 
07 PAB flag field (PABFLGS1) 
Bit Meaning 
Te8 i raat Switch the PST address of this PAB’s major control block 
to the new PST address contained in DYPNWPST. 
-l.. .... | This PAB has a data space extension. 
.-l. .... | This PAB’s major control block is an FMCB. 
..l1 .... PAB can be referenced in PSW disable mode. 
. 1... PAB is persistent. 
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-1... APSTERM/APSINIT FMCB during PAB dispatch. 

deocnee ss xx Zero. 

08—O0B PST address 

OC-—OF PAB address 

10-13 Work element address or next dispatchable queue level for a very 
extended PAB 

14-17 PAB work element queue 

18-1B PAB DVT address or name 

1C—1F Request parameter header (RPH) Address. 
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SCHD Entry for Schedule of PAB Dispatch 


Entry: SCHD 
VIT Option: PSS 
Event: Schedule of PAB dispatch 


VIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCTS 


Applies to: 


This trace record shows the schedule of a PAB to be dispatched and the last work 
element, if any, that was queued to the PAB. This entry should be followed shortly 
by a DSP entry, representing the PSS dispatch of this PAB. 


4HeAb HE HBF aBHE ABBE aes 
alt 4HHE HEHE peal ABE HAE HABE 


SCHD PST PAB RETURN |WORK EL}MODULE |RPH 
; i ADDRESS | ADDRESS | ADDRESS /|Q OR 
A 
T 


Byte (hex) Contents 
00-03 Record ID: C'SCHD' 
04 ID is one of the following: 
| ¢ Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 


OND > 


05 Status 
Bit Meaning 
MX de: aoe Zero 
..l. .... | TPSCHED unconditional 
sek eoax ~ZOLO 
. 1... Registers are saved in the RPH control block. 
sea-eXes. 2ZETO 
....- «1. PAB work element queue gate bit (PABWEQG). 
pene: Se @ PAB change bit (PABCHNG) = 0 if the PAB is not scheda- 
uled to run. 
Pelee 1 PABCHNG=1 if the PAB is scheduled to run. 
06 PAB flag field (PABFLAGS) 
Bit Meaning 
Lacth~ Bet PAB is unconditionally scheduled. 


.1.. .... | PAB closedown is in progress. 
..l. .... PAB is synchronous. 
..1 .... PAB extension is present. 
. 1... Do not dequeue work element. 
. -l.. Do not detach the RPH. 
..e. «el. Indicates a very extended PAB. 
emanates 1 Indicates a slightly extended PAB. 
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SCHD 


07 


08-0B 
OC-OF 
10-13 
14-17 


18-1B 


1C-1F 
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PAB flag field (PABFLGS1) 

Bit _ Meaning 

ee Switch the PST address of this PAB’s major control block 
to the new PST address contained in DYPNWPST. 

.l.. .... | This PAB has a data space extension. | 


..l. .... | This PAB’s major control block is an FMCB. 
.-1 .... PAB can be referenced in PSW disable mode. 
. 1... PAB is persistent. 
1... APSTERM/APSINIT FMCB during PAB dispatch. 
‘Coes. we xx Zero. 


PST address associated with PAB 

PAB address 

Address of the issuer of the TPSCHED macro 

PAB work element queue or next dispatchable queue level for a very 
extended PAB | 

Module name abbreviation (bytes 4, 5, 7, and 8 of the module name), 
or PAB DVT address (high order bit of X'18' = 0). The module name 
might be unavailable if the PAB being scheduled is associated with an 
address space different from the current one 

Request parameter header (RPH) Address. 
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SIO Entry for Start I/O for X.25 Port 


Entry: SiO 
VIT Option: ClO 
Event: Start 1/O 


VIT Processing Module: |ISTRACTR (SNAP trace recording routine) 
Control is Returned to: ISTAPCES 


Applies to: 
This trace record provides information about Start I/O at the channel interface for 
an X.25 port. 


The telecommunications subsystem or communication adapter uses two channel 
programs: a control-link channel program and a buffer-pool channel program. An 
SIO entry is built whenever one of these channel programs is started. These 
channel programs run continuously and stop only in case of error or when the 
adapter stops. 


O/O/O/O;O;O/O/O;/O/O;O/O;O;O;O/O; 1; LiL)ApL AL AjAs~LjiAji_p1jiayii1 
O)1/2)3/4)5)6)/7/ 8/9 A/BiC|DIE]F/0;1/2)3)4/5)6)7) 8/9 A; BiC|D\E| F 


SIO j;T)}I}| CUA |P DUMP OF WRITE CONTROL AND READ CONTROL 
Y|D F DATA AREAS 
P S 
E M 


Byte (hex) Contents 
00-02 Record ID: C'SIO' 
03 Type: 
OC = Control link channel program 
OD = Buffer pool channel program 
04 ID is one of the following: 
e Machine ID and Task ID 
e [Sa Task ID 
Channel device name in EBCDIC (either a CUA or device number) 
08 Packet finite state machine (PFSM) 
09 Zero 
OA-1F Dump of Write Control and Read Control data areas. 
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S!iOx Entry for Start I/O (Part 1) 


Entry: SIOB, SIOH, SIOI, SIOL, or SIOX 
VIT Option: ClO 
Event: Start I/O (Part 1) 


VIT Processing Module: ISTRACCI 
Control is Returned to: ISTTSCIO or ISTTSCLC 


Applies to: 


This trace record is written when a Start I/O SVC is issued for a channel-attached 
communication controller or SNA cluster controller. 


e SIOI is generated for communication controllers and local SNA cluster control- 
lers. 


_e SIOL is generated for local non-SNA cluster controllers. 


e SIOX is generated for channel-to-channel-attached hosts and channel-attached 
IBM 3172 Interconnect Controllers. 


Eventually, an INT entry follows the SIO trace record. Use the CUA field to corre- 
late the entries. See V7AM Data Areas for MVS/ESA, VTAM Data Areas for 
VM/ESA, or VTAM Data Areas for VSE/ESA for a description of the NCB fields. 


od HH HE HAE SHEP AHE 
4H AH E ele HBAE ABHE 


STIOB CUA NCB FLAG 
or A DEVICE |ADDRESS; BYTES 
SIOH D |. 

I 

D 


CUA NCB FLAG CAW 

DEVICE |ADDRESS| BYTES 

CUA NCB FLAG CAW CCW or OUTPUT 

DEVICE jADDRESS;| BYTES CONTROL AREA 
(STATUS 
INFORMATION) 


Byte (hex) Contents 
00-03 Record ID: 
C'SIOB' for BSCLB 
C'SIOH' for HALCB 
C'SIOI' for ICNCB 
C'SIOL' for LDNCB 
C'SIOX' for XCNCB 
04 ID is one of the following: _ 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 


=n 


ANA =a re 
Or UO s 


moAaraAan 
Or OOF 
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05 


06-07 
08-0B 
OC-OF 
10-13 
14-17 
18-1F 


SIOx 


e Task ID 
For SIOB or SIOH: link finite state machine (LFSM) 
For SIO! or SIOL: link station state (NCBLNKST) 
For SIOX: station state (XCNSSFSM) 
Module ID (last two characters of TSC module name) 


~Channel device name in EBCDIC (either a CUA or device number) 


NCB address 

Flag bytes (NCBFLAGS) 

Virtual channel address word (NCBCAW) 

For SIOB and SIOH: Zero 

For SIO! and SIOL: Zero 

For SIOX: 
e If link is active, output control area (status information) 
e If link is not active, first channel command word (CCW). 
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$lO2 Entry for Start I/O (Part 2) 


Entry: SlO2 

VIT Option: ClO | 
Event: Start I/O (Part 2) 
VIT Processing Module: ISTRACCI 
Applies to: 


This trace record is a continuation of the SIO entry. 


OOO OOOO OOOO O;O;O;O;O; TID DID dy lp LyLi1idplidsdiiiii | 
0}1)2)3)/4/5/6)7/8)9;A/BiC| DIE} F/O} 1) 2)/3)4/5)6)7/8/9) A; B/C) DIE] F 


FIRST MPC PDU 
HEADER 


VIRTUAL} MPC TRANSMIT 
BLOCK HEADER 


0/0/0)O/O;O/O;O/O;/O;O/O/O;O;O;O; 1); 1; 1) 2) 1; 1) 1) 2)2) 1) 1) 1) 2)1)1)1 
0)1)2)3)4/516)7)8)9/A|/BiC} DIE} F/O) 1) 2)3)4)5)6)7/8) 9A; Bi C|DIE|F 
M 


1 
S102 |E|T/E/R DEVICE-DEPENDENT INFORMATION E 
or 0 R 
A 
C 
T 
Byte (hex) Contents 


00—03 Record ID: C'SIO2' 


AO Pw 

4aAoOm 
moon 
Ore © 


DON Dw 


04-07 
e When multipath channel (MPC), 
04-07 Virtual buffer address of the first READ CCW, or zero 
e When device other than MPC, 
04 ERACT or zero 
05 Temporary error counter (TECT) 
06 Error code (NCBERCOD) 
07 Return code or zero 
08-—1F 


e When multipath channel (MPC), 
08—OF MPC transmit block header 
10-19 First MPC PDU header 


1A-1D Zero 
1E Error action (ERACT) or zero 
1F Zero | 


e When device other than MPC, 
08—09 Module ID 
OA-19 Device-dependent information shown below, or zero 


1A-1D Zero 
1E Error action (ERACT) or zero 
1F Zero 

For SDLC links (NCBTYPE=09): 

OA Index to current PUT 

OB Station flags 
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oC Station finite state machine 
oD Connection finite state machine 
OE—OF Connection manager flags 


10-19 First 10 bytes of CCW command code 
For BSC links (NCBTYPE=0A): 


0A Current channel program finite state machine 
(BSCCCFSM) 

0B Original channel program finite state machine 
(BSCOCFSM) 

0C Previous channel program finite state machine 
(BSCPCFSM) 

OD Original failing channel program finite state machine 
(BSCFCFSM) 

OE First selection character (BSCSEL1) 

OF First device address (BSCDEV1) 

10 Index of BPL entry for which input data was received 
(BSCPESV) 

11 Device address from which input data was received 
(BSCDEVSV) 

12 Index for last station for which there was output data 
(BSCISOD) 

13 First response byte (BSCRSPA1) 

14 Second response byte (BSCRSPA2) 

15 Last block type received (BSCLBR) 

16 Current acknowledgment (BSCALTAK) 

17 Error retry count (BSCRCNT) 

18 Connection manager flags (BSCCMIO) 

19 BSC flags (BSCFLAGS). 
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SIOP Entry for Start I/O 


Entry: 


VIT Option: 


Event: 


VIT Processing Module: 
Control is Returned to: 


Applies to: 


SIOP 

ClO 

Start I/O for token- -ring subsystem | (Part 1) 
ISTRAC6T 

ISTTSC6F 


This trace record is created when a Start I/O SVC is issued for the Token-Ring 
Subsystem. Channel programs started for the subsystem do not always complete. 
If the channel program completes, this entry is eventually followed by an INT entry. 
Use the CUA field to correlate the entries. 


Byte (hex) 
00-03 
04 


05 


06-07 
08 
09—0B 
OC-—OF 
10 


11 
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4Hiab aHHAHE 
HHHb HUH E AHHE 


STOP ai 


CUA |NCB 
P ADDRESS 


Contents 
Record ID: C'SIOP' 


ID is one of the following: 


Machine ID and Task ID 


[Sa Task ID 
Channel! program FSM 
00 Reset 
01 Sense ID 
02 Interrupt port 
03 Control port 
04 Running 
05 Sense 
06 Orderly halt (HLTC) 
07 Termination 
08 Shutdown 
Module ID (last 2 characters of TSC module name) 
Zero 


Channel device name in EBCDIC (either a CUA or device number) 
NCB address 
Port state (PDATA) 


00 Reset 

01 Halt 

02 Halt complete 

03 Sense ID 

04 Sense ID complete 
05 = Interrupt pending 
06 Active 

07 Sense 

Port type (PDATA) 

00 Interrupt 
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12-13 
14-17 
18 


19-1F 
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01 Control 
02 = Inbound 
03 Outbound 
Zero 


Channel address word 
Channel-command code for the first CCW 
C4 Sense control unit state 

CB Set CETI mode on 

E4 Sense ID 

Zero. 
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SOCx Entry for SOCTREE ADD, DELETE, FIND, and RELEASE Macros 


Entry: SOCA, SOCD, SOCF, or SOCR 

VIT Option: TCP 

Event: SOCTREE ADD, DELETE, FIND, and RELEASE 
macros 

VIT Processing Module: ISTRACIP 

Control is Returned to: ISTIPCMT 

Applies to: 


This trace record is written when a VTAM module issues a SOCTREE ADD, 
DELETE, FIND, or RELEASE. 


Byte (hex) 


00-03 


04 


05 


06 


07 
08-0B 


0C-OF 
10-13 
14-1B 
1C-1F 
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a lel oe 4HHE 12/24 ABE 
AHHe 4KHE HHA alalelo 


SOCKET CORRELATOR RPH 

CONTROL FROM THE ADDRESS 
BLOCK MPTN KEY 
ADDRESS 


Contents 
Record ID: 


C'SOCA' for SOCTREE ADD 

C'SOCD' for SOCTREE DELETE 

C'SOCF' for SOCTREE FIND | 

C'SOCR' for SOCTREE RELEASE 
ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
Locking level on TREELOCK 


.Code Meaning 
X'01' Exclusive 
X'02' Share 


SOCTREE return code 
Code Meaning 


X'00' Successful invocation 

X'01' Socket already exists in the tree 
X'02' Socket was not found in the tree 
Zero 


Address of the socket control block during an add, a successful find, or 
a delete. Otherwise, this field is zero. 

Zero 

Address to which the macro returns control 

Procedure correlation identifier (PCID) 

Request parameter header (RPH) address. | 
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SPT Entry for SPT Macro Invoked (Part 1) 


Entry: SPT 
VIT Option: SSCP 
Event: SPT macro invocation 


VIT Processing Module: ISTRACSC 
Control is Returned to: ISTCPMSP 
Applies to: 


This trace record is written when partner LU mapping information in the coupling 
facility structure ISTGENERIC is created, deleted, or changed using the SPT 
macroinstruction. 


O/ojOlo;O;O;O;O/GlOlelOloloOlolO;1i1{ajajafafajafajafajajajrjal1 
0/1)2)3)4)5/6/7/8)/9)A)BiC|DJE}F/0)/1)2)3)4)/5)6)7)8|9}A|BiC|DIE}F 


SPT R} Fj} F} GENERIC RETURN | REAL RPH 
T}U|L) NAME ADDRESS | RESOURCE 
NINJA 
Ci\C\G 
Di |S 


Byte (hex) Contents 
00-03 Record ID: C'SPT' 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
05 Return code from the SPT macro 
06 Reason macro invoked: 
X'01' Find an SPT entry 
X'02' Add a session pair to the SPT entry 
X'03' Decrement the session count for a session pair 
X'04' Increment the session count for a session pair 
X'05' End the affinity between the generic resource and its 
partner LU 
X'06' Start an affinity between the generic resource and its 
partner LU 
X'07' Delete a session pair in a SPT entry 
X'08' Free local SPT entry that was read from the coupling 
facility structure 
07 Flags: 
Kelse. Siaets Name type 
B'0' Real names only 
B't' Generic names allowed © 
1... .... This SPT will persist until the application issues the 
CHANGE OPTCD=ENDAFFIN macroinstruction. See 
Chapter 13, “Conventions and Descriptions of VTAM 
Macroinstructions” in VTAM Programming for additional 
information. 
»»X. «... Ownership indicator 
B'0O' VTAM-owned 
B'1' Application-owned 


oe eX XXXX Zero 
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08—OF Generic resource name 
10-13 Address of the issuer of the SPT macro 
14-1B Application program network name 


1C-1F Request parameter header (RPH) Address. 
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SPT2 Entry for SPT Macro Invoked (Part 2) 


Entry: SPT2 

VIT Option: SSCP 

Event: SPT macro invocation 
VIT Processing Module: ISTRACSC 

Applies to: 


This trace record is a continuation of the SPT entry. 


alsisle 4HHE eal sl lala 
4HHE 4H HEE él lala 


SPT2 SIB PCID 
COUNT 7 


Byte (hex) Contents 
00-03 Record ID: C'SPT2' 


04-07 Count of number of session information blocks (SIB) that have been 
created for this SPT entry 

08—OF PCID if associated with a session, otherwise zero 

10-17 Partner NETID 


18-1F Partner resource name. 
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SRBD Entry for SRB Dispatch 


Entry: SRBD 

VIT Option: PSS 

Event: SRB dispatch 
VIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCAD 
Applies to: 


This trace record provides information when PSS is dispatched under an SRB. 


Note: For this trace record to be created, in addition to specifying the PSS option, 
you must specify SRB or BOTH on the PSS TRACE start option. 


ajolojolelojalolelojelojojejojol1}ajaj2fajajajafafajafajafaiala 
0}1}2)3)4)5/6/7/8/9;A|BIC|DJE} FIO} 1)2)3)4)5)6)7/8)/9) A; Bi CDI E| F 


SRBD PST PST TCB Peis 
ADDRESS | LIFO ADDRESS] L 

G 

] 


Byte (hex) Contents 

00-03 Record ID: C'SRBD' : 

04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05-07 Zero 

08—0B PST address 

OC-—OF PST LIFO asynchronous dispatchable queue (PSTADSP) 

10-13 PST FIFO asynchronous dispatchable queue (PSTALIST) 

14-17 PST asynchronous nondispatchable queue (PSTANDSP) 

18-1B TCB address (PSTTCBA) 

1C-1D PST flags (PSTFLG1) 

1E-1F Zero. 
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SRBX Entry for SRB Exit 


Entry: 3 SRBX 
VIT Option: PSS 
Event: SRB exit 


VIT Processing Module: ISTRACPS | 
Control is Returned to: ISTAPCSX, ISTAPCTX, or ISTAPCAD 


Applies to: 


This trace record provides information when PSS exits an SRB. For this trace 
record to be created, you must specify the PSS VIT option, and you must specify 
SRB or BOTH on the PSSTRACE start option. 


be Blais alslels a ied SHHE dBHe “HEE 
alSlels fone aH E SBHE BRE Hie 


SRBX PST 
ADDRESS | LIFO 


Byte (hex) Contents 
00-03 Record ID: C'SRBX' 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 
05 Reason code for SRB exit 


06-07 Zero 

08—OB PST address 

OC—OF PST LIFO asynchronous dispatchable queue (PSTADSP) 
10-13 PST FIFO asynchronous ore queue (PSTALIST) 
14—17 New ASCB address 

18-1B Old ASCB address 

1C—1F Address of the module issuing the SRBX trace event. 
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SRTx Entry for SRTADD, SRTCHG, SRTDEL, SRTFIND Macros 


Entry: SRTA, SRTC, SRTD, or SRTF 
VIT Option: NRM 
Event: | SRTADD, SRTCHG, SRTDEL, SRTFIND macros 


VIT Processing Module: ISTRACNR 
Control is Returned to: ISTNRCSA for SRTADD 
ISTNRCSD for SRTCHG, SRTDEL, and SRTFIND 


Applies to: 


This trace record contains information about a SRTADD, SRTCHG, SRTDEL, or 
SRTFIND macroinstruction issued by a VTAM module. 


a a 4HBF “HHE jee 
HEE HAE AEAE 


HASH NAME RETURN | SRT NETWORK ID 
(NAME OR ADDRESS | ENTRY 
NETWORK 
ADDRESS) 


Byte (hex) Contents 
00-03 Record ID: C'SRTA' (SRTADD), C'SRTC'(SRTCHG), C'SRTD' 
| (SRTDEL), or C'SRTF' (SRTFIND) 

04 ID is one of the following: 

e Primary address space ID 

This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID 
e Task ID [Ra 


05 Return code. See the SRT control block in VTAM Data Areas for 
MVS/ESA, VTAM Data Areas for VW/ESA, or VTAM Data Areas for 
VSE/ESA. 

06 Zero 

07 Type of SRT entry. For the types, see the SRT control block in VTAM 
Data Areas for MVS/ESA, VTAM Data Areas for VM/ESA, or VTAM 
Data Areas for VSE/ESA. 

08—OF Network name or network address (padded on left with zeros) passed 


to the hashing algorithm 

10-13 Address of the issuer of the SRTADD, SRTCHG, SRTDEL, or 
SRTFIND macroinstruction 

14-17 Address of SRT entry for the resource 

18—1F Network ID of the resource. 
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SRT2 Entry for the SRTADD Macro 


Entry: SRT2 

VIT Option: NRM 

Event: SRTADD 

VIT Processing Module: ISTRACNR 
Applies to: 


This trace record is a continuation of the SRTADD entry. It is written after an 
SRTADD failure if the duplicate SRTE is contained in or points to an RDTE. 


O/O;O/O/O/O/O/OO/O/O/O;O;O/O/OlLPLJLiLiLpLpLpLpLyapapayayayaya 
(704 14243)4) 5/6) 7) 8/9 Al BIC DIE} F) Oj 1) 2)3)4)5)6)7)8|9{A|BiC|DIE|F 


SRT2 |S|FIR}T| RPRNAME SRTDATA NETWORK ID 
OR 0 


Byte (hex) Contents 
00-03 Record ID: C'SRT2' 


ND Yr 
mwo-< 


04 SRTUSELN from the duplicate SRTE; this is a 4-byte field in the SRTE 
and will be set to X'FF' in the SRT2 if SRTUSELN is greater than 
X'FF'. 

05 The first bit is SRTSPECE; the other 7 are not used. 

06 RPRENTRY of the duplicate RDTE 

07 SRTTYP from the duplicate SRTE 
X'00' RDTE 
X'03' Shadow 


X'09' Alias name 
X'OA' Network address 
X'FF' SRTE 
08—OF RPRNAME of the duplicate RDTE 
10-13 SRTDATA from the duplicate SRTE or 0. 
14-17 Not used 
18-1F Network ID of the duplicate RDTE. If RPRENTRY is RPRENTRC, it is 
RCDNETID; otherwise, it is ATCNETID. 
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TGM Entry for APPN TG Management (Part 1) 


Entry: TGM 
VIT Option: SSCP 
Event: APPN TG management event 


_ VIT Processing Module: ISTRACSC 
- Control is Returned to: ISTATCTR 


Applies to: 


This record is generated when one of the following APPN TG management events 
has occurred: 


Add an ATGB to an ATGB chain 
Remove an ATGB from an ATGB chain 
Find an ATGB 

Activate a TG number 

Deactivate a TG number 

Negotiate a TG number. 


If TGFIND fails to locate an ATGB, a trace entry will still be recorded. 
O/O/O/O/O/O/O/O/O/O;O/O/O/O;O;O] 1/1; 1) 1; LiL) 1y1y_plplyljijiyiy. 
0)1)213)4)5)6)7/8/9/ A/B/C) Di E}F/0}1)2)3)4)5)6)7/8)9)A}B)C|DIE|F 


TGM |T R ADJCP |D/C;}C}T| CPNAME CALLER |RETURN 
C ADDR |Y/0O/P/G| ADJACENT NODE |NAME ADDR 
NINI CIF | 
FIC} T|S 


Byte (hex) Contents | 
00-02 Record ID: C'TGM' 


03 Type field 
Code Meaning 
C Activate transmission group number (TGN) or APPN trans- 


mission group block (ATGB) 


D Deactivate TGN or ATGB 
A Add an ATGB 
R Remove an ATGB 
F Find an ATGB 
N Negotiate a TGN 
04 ID is one of the following: 


e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID | 
05 APPN TG Management function values 

e Network node specification 
0: Not a network node 
1: Network node 

e RU being processed 
0: Request Contact 
1: Contacted 

e TG number coded on macroinstruction 
0: Not specified 
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1: Specified 
e Display CV47 
e APPN connection pending, not reported to topology (LIMBO) spec- 
ification 
0: No 
1: Yes 
¢ Vector format 
0: Key-length format 
1: Length-type format 
e Assigned chain specification 
0: Assigned not specified 
1: Assigned specified 
e Unassigned chain specification 
0: Unassigned not specified 
1: Unassigned specified 


06 The calling module's return code. Zero if no return address is pro- 
vided. | 

07 Unused available 

08—OB Adjacent control point (ADJCP) address 

oC Dynamic indicators received in XID3 exchange (ADJDYNFL) 

OD Number of active connections controlled (ADJCONCT), last digit 

OE Connections controlled by the ADJCP (ADJCPCT), last digit 

OF Transmission group number state map (ADJSTMP), indexed by TGN 

10-17 CPNAME of the adjacent node 

18-1B Calling module name 


1C-1F Return address. 
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TGM2 Entry for APPN TG Management (Part 2) 


Entry: TGM2 

VIT Option: SSCP 

Event: _ APPN TG management event (Part 2) 
VIT Processing Module: ISTRACSC 

Applies to: 


This trace record is a continuation of the TGM trace record. 
O/O/O/OIOO/O/O/OlO OO; LILILILILiL LT 11s 1iliiiilijyii1 
314/51/617/8/9}A|B/C|D F/O] 1}2)3}4/5]6/7/8/9}A|B)C)DE|F 


PU of | ATGB |TIT PUPTR | NXTPT 
ADDRESS |G] 0 
NIP ATGB | ATGB 
—— TUTR 


TOP TOP 
Byte (hex) Contents 
00-07 Overlay 1 
e 00-03 Record ID: C'TGM2' 
¢ 04-07 PU of current ATGB 


Overlay 2 
e 00-03 Record ID: C'TGM2' 
e 04-06: Unused, available 
e 07: Received TGN 
08-—0B ATGB address 


0 


D 
Y 


oC ATGTGNUM 
0D ATGTOPR 
OE ATGDYNFL 
OF ATGPOS 


10-13 ATGPUPTR: Top ATGB in the chain 
14-17 ATGNXTPT: Top ATGB in the chain 
18-1B ATGPUPTR: Next ATGB in the chain 
1C-—1F ATGNXTPT: Next ATGB in the chain. 
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TREx Entry for 


TREx 


Routing Tree Build or Update 


Entry: 
VIT Option: 
Event: 


TREM, TRED, TREI, or TREB 
SSCP 
Routing tree Build or Update 


VIT Processing Module: ISTRACSC 
Control! is Returned to: Module invoking the INTRACE macro that caused the 


Applies to: 


record to be produced. 


A routing tree operations (TRE) VIT entry is created by topology and routing ser- 
vices (TRS) whenever one of the following events is encountered: 


e TRS accesses or builds a routing tree to satisfy a request for an APPN route. 


e An existing routing tree is marked for modification due to a topological change 
in the APPN network. 


e TRS learns of the availability or loss of a central directory server or interchange 


node. 


I 
D 


Byte (hex) 
00—03 


04 


05 


0/0)0)0/0/0/0/0)0;0)0)0/0)0 
0)1)2/3)4/516)7/8)/9{A;B/C|D 


OO;L LT Ly LpLpApLpApApApApApAylyay1 
E|F/0)1/2)3)4)5}6}7/8|9}A|B/C|Dj{E|F 


MJA|T| PATH RETURN |ORIGIN 
R|WEIGHT |HEADER |ADDRESS| TREE 
| RECORD | RECORD 


Oo 
mm 


Aw > 


OR POINTER| POINTER 
SEQ 


POINTER| MODULE 


OM Y>rmn 


Record ID: 
C'TREM' Mark tree 
C'TRED' Add or change directory server 
C'TREI!' Add or change interchange node 
C'TREB' Build tree 
ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
Tree marking flags 
Bit Meaning 


1=Operable resource state 
O=Inoperable resource state 


ENN ae Reason 


000=Transmission group update 
001=Topology database update 
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010=Garbage collection 
011=Overuse 
100=Modify topology 
110=Uncache tree 


~ XXxx Zero. 7 | 
06 Indicates that a directory server or interchange node is added ('A') or 
deleted ('D') | 
07 Tree building flags 
Bit Meaning 
Nice. caer Indicates whether existing tree is used 


1=Existing tree is used 
0=New tree is built; existing tree is not available 


.X.. .-.. Indicates whether clean path is used 


1=Clean path is used 
O=Clean path is not available 


.eX. ..s. Indicates number of destinations 


1=Multiple 
— 0=Single 
08—0B Indicates the entry type. 
Entry 
Type Meaning 
B Path weight 
M Resource sequence number 


Note: If entry type is TREB and the destination tree record pointer 
indicates multiple destinations, the path weight field is not valid. 


OC-—OF 

Entry 

Type Meaning 

B Tree header pointer 

M Topology database resource pointer 
10-13 Return address of caller 


14-17. Origin tree record pointer or COS pointer 
e Origin tree, if entry type is B 
e COS pointer, if tree marking flags are ('110') 
18-1B Destination tree record pointer or calling module 
e Destination tree record pointer, if entry type is B 
e Last 4 characters of calling module name, if tree marking flags are 
('110') 
1C—1F Tree building execution time (microseconds), if entry type is B. 
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TRNM Entry for Translate Message (Part 1) 


Entry: | TRNM 
VIT Option: MSG 
Event: Translate message error (Part 1) 


VIT Processing Module: ISTRACOT 
Control is Returned to: ISTUSCMS or IKTMSIFR 


Applies to: 


This trace record is generated when a return code greater than the value 4 is 
received from the TRANMSG macro. When the return code and reason code indi- 
cate that the MVS message service is not active, no TRNM trace record is gener- 
ated. A single message is translated each time the TRANMSG macro is invoked. 


0/0; O/O/O/O/O;/O;/0/O/0;0/0;0/0; 0) 1) 1) 1) 17172) 2) 1) 171; 2y ly ajay.y. 
0}1}2)3/4/5|6}7/8)9}A}B/C)DJE}F}0}1)/2)3)4)5)6)7)8)9;A;B/C)DIE|F 


TRNM LANG |MESSAGE|MESSAGE|RETURN |REASON |MPB MTB 
CODE CODE CODE ADDRESS | ADDRESS 
ADDRESS | LENGTH 


Byte (hex) Contents 
00-03 Record ID: C'TRNM' : 


04 ID is the primary address space ID (ASID). This field is zero if the 
ASID is greater than X'FF'. 

05-07 Three-character language code or blanks if language is not supported 
Hex Value Language Code Language Name 
X'02!' ARA Arabic 
X'03' CHT Traditional Chinese 
X'04! CHS Simplified Chinese 
X'05! DAN Danish 
X'06' DEU German 
X'07' . DES Swiss German 
X'08' ELL Greek 
X'09! ENG UK English 
X'00' US English (default) 
X'01' ENU US English (specified) 
X'0OA' ESP Spanish _ 

X'0OB' FIN Finnish 
X'0C! FRA French 
X'OD' FRB Belgian French 
X'OE' FRC Canadian French 
X'OF ' FRS Swiss French 
X'10' HEB Hebrew 
X'12' ISL ~ Icelandic 

~— XK'13! ITA Italian 
X'14' ITS Swiss Italian 
X'11! JPN Japanese 
X'15' | KOR Korean 
X'16' | NLD Dutch 
X'17' NLB | ~ Belgian Dutch 
X'18' NOR Norwegian 
X'19! PTG Portuguese 
X'1A' PTB Brazil Portuguese 
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Hex Value Language Code Language Name 

X'1B' RMS Rhaeto-Romanic 

X'1C! RUS Russian 

X'1D' SVE Swedish 

X'1E' THA Thai 

X'1F! TRK Turkish 

X'3F' Unknown language code 


08—0B Message input/output block address 
OC-—OF Message input/output block length 
10-13 Return code 


14-17 Reason code 

18-1B = Input message parameter block address (MIOINPTP). If a message 
text block or text is supplied instead, 18—1B is the address of the text 
block or text. 


1C—1F Output message text block address (MIOBUFFP). 
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TRN2 Entry for Translate Message (Part 2) 


Entry: TRN2 

VIT Option: MSG 

Event: Translate message error (Part 2) 
VIT Processing Module: ISTRACOT 

Applies to: MVS 


This trace record is a continuation of the TRNM entry. It is generated when a 
TRNM entry is produced and the input to the TRANMSG macro is the address of a 
message parameter block. 


o|9}ajs AHH pei ie a 
aft HE HHHE aHHh ella 


SECOND THIRD 


MESSAGE MESSAGE 
VARIABLE VARIABLE 
OR 0 OR 0 


Byte (hex) Contents 
00-03 Record ID: C'TRN2' 


04-07 Last four digits of the message ID (for example, 0200 for message 
IKTO200I, or SGO2 for USSMSG02) 

08—OF First 8 bytes of the first message variable, if present; otherwise, zero 

10-17 First 8 bytes of the second message variable, if present; otherwise, 
zero 

18—1F First 8 bytes of the third message variable, if present; otherwise, zero. 
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UE Entry for USER Exit (DFASY or RESP) — 


Entry: UE 
VIT Option: API 
Event: User exit (DFASY or RESP) 


VIT Processing Module: ISTRACAP 
Control is Returned to: ISTAPCUE 


Applies to: 


This trace record identifies the exit dispatched and data passed back to the user 
application program. 


If this entry is associated with an event failure (that is, the return code is non-zero), 
this entry will be generated whether or not the API option is in effect. It is treated 
as an exception condition and is always traced, regardless of the VIT options speci- 
fied, if the VIT is active. 


For DFASY and RESP exits (type codes = 07 and 08), the user exit trace record 
has the following format: 


OO O/O/O;O;O/OO;O;O;O;O;O;O;O; 1; LiLiLi1jijlj2j2j1iijijij1j1)i1 
10}1/2/3/4)/5/6)7/8/9/A/B/C{D|E|F{O)1)/2)/3)4)5)6;7;8{9|A| BIC) DEF 


CIE/T| RY FY FI RPL EXIT RPL RPL CID RPL 
X|D}1T;D}D| ADDRESS} ADDRESS| AREA RLEN OR 0 FDBK2 
T BiB 
D 2\3 
S 


Byte (hex) Contents 


mo © 
oe TE ap <a | 


00-01 Record ID: C'UE' 

02 Exit type code (hex 7=DFASY, hex 8=RESP) 
03 Exit definition (RPLEXTDS) 
04 ID is one of the following: 


¢ Primary address space ID 

This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID 
¢ Task ID 


05 Return code (RPLRTNCD) (See “RPL-Based Macroinstruction Errors 
and Special Conditions” in VTAM Programming) 

06 Feedback code (RPLFDB2) (See “RPL-Based Macroinstruction Errors 
and Special Conditions” in VTAM Programming) 

07 Feedback code (RPLFDB3) (See “RPL-Based Macroinstruction Errors 


and Special Conditions” in VTAM Programming) 
08—0B RPL address 
O0C-—OF Exit address 
10-13 RPL data area pointer (RPLAREA) or zero 
14-17 Record length (RPLRLEN) | 
18-1B CID from NIB or RPL (RPLARG) or zero | 
1C-—1F Second RPL feedback area — Sense code (RPLFDBK2). 
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UE1 Entry for USER Exit (not DFASY or RESP, Part 1) 


Entry: UE1 

VIT Option: API 

Event: User exit (not DFASY or RESP, Part 1) - 
VIT Processing Module: ISTRACAP 

Control is Returned to: ISTAPCUE 


The user exit trace record (not DFASY or RESP, Part 1) has the following format: 


dD o|0]9/0 rlelali ABE 
alt ABE ‘lrleli ABBE 


Applies to: 


I EXIT-TYPE PRIMARY SECONDARY 
DEPENDENT (APPL) LU NAME 
INFORMATION LU NAME OR 0 


Byte (hex) Contents 
Record ID: C'UE1' 
ID is one of the following: 

e Primary address space ID 

This field is zero if the ID is greater than X'FF'. 

e Machine ID and Task ID 

¢ Task ID 
Exit type code (see Table 35) 


00-03 
04 


05 

06-07 
08-OF 
10-17 
18-1F 


zero 


Exit-type-dependent information (see Table 35) 
Primary (application program) logical unit name 
Secondary logical unit name, or zero if this is a TPEND exit. 


Table 35 (Page 1 of 2). Exit-Type-Dependent Information for a UE1 Entry 


Exit 
Type 
Code 


05 


05 


05 


06 


09 


Exit 
Type 
SCIP (BIND) 


SCIP (STSN) 


SCIP (other) 
LOGON 


LOSTERM 
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Byte 
(hex) 


08-09 

OA-OF 
08-09 

OA-0B 
0C-—0D 
OE 


OF 


08-09 
OC-OF 
08-0B 
OC-OF 
08-0B 
OC-OF 


Contents 

RPL control flags (RPLCNTDC, RPLCNTSC) 
Session parameters 

RPL control flags (RPLCNTDC, RPLCNTSC) 
RPLOBSQV 

RPLIBSQV 

RPLOBSQ 

RPLIBSQ 

RPL control flags (RPLCNTDC, RPLCNTSC) 
CID | 

Logon data length 

CID 

Reason code 

CID 
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Table 35 (Page 2 of 2). Exit-Type-Dependent Information for a UE1 Entry 


Exit 
Type 
Code 


OA 
0D 


OE 
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Exit 
Type 
RELREQ 
TPEND 


NSEXIT 


Byte 
(hex) 


08—OF 
08-0B 
O0C—OF 
08—OF 


Contents 
Unused 

Reason code 
Unused 

NS RU bytes 0-7 
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UE2 Entry for USER Exit (not DFASY or RESP, Part 2) 


Entry: UE2 

VIT Option: API 

Event: User exit (not DFASY or RESP, Part 2) 
VIT Processing Module: ISTRACAP 

Applies to: 


This trace record is a continuation of the UE1 entry. 


0}0/0/0;)0;0;0)0 
0} 1)2)314/5)6)7 


UE2 |EXIT 
| ADDRESS 


Byte (hex) Contents 

00—03 Record ID: C'UE2' 

04—07 Exit address 

08-17 Zero 

18-1F Network identifier, or zero if this is a TPEND exit. 
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ULKA Entry for Release All Locks 


Entry: ULKA 
VIT Option: | LOCK 
Event: Release all locks 


VIT Processing Module: ISTRACLK 
Control is Returned to: ISTAPC39 


Applies to: 
This trace record contains information about a routine releasing all locks it currently 
holds. 


“Free” 
ADDRESS | LOCK ADDRESS 
04 ID is ‘one of the following: 

e Machine ID and Task ID 
06—07 Zero 
10-13 Address of the issuer of the TPUNLOCK macro 


Byte (hex) Contents 
e Primary address space ID 
© Task ID 
08—0B PST address 
14-1B Zero 


EEC ae 
0}1/2/314/5/6]7/8/9/A/B/C/D/E/F/0/1/2/3)4)5|6)7/8/9/A/BIC/DIE|F 
00-03 Record ID: C'ULKA' 

This field is zero if the ID is greater than X'FF'. 
05 Zero 
OC—OF CRA lock account word (CRALKACT; see step 12 on page 79) 
1C—1F Request parameter header (RPH) Address. 
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UNLK Entry for Release a Lock 


Entry: UNLK 

VIT Option: LOCK 

Event: Release a lock 
VIT Processing Module: ISTRACLK 
Control is Returned to: ISTAPC33 
Applies to: 


This trace record contains information for a routine releasing a lock. It is the com- 
plement of a LKEX or LKSH entry. 


CRRCHCHECHECHECHACHECIECHECHRCHECHACHRCHECHEC PGP GU SECU GU G00 000000000 nan ama 
Oj 1) 2)3/4) 5/6) 7/8 9A; B/C|DI EF) 0) 1)2)3)4)5,/6)7;8)/9/A\B/C|DJE]F 


UNLK L L}LOCK RETURN | LOCKWORD RPH 
O E|ADDRESS| LOCK ADDRESS ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C'UNLK' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 


05 Zero 
06-07 Level of lock to be released. (See Table 7 on page 80 for a listing of 
VTAM locks.) | 


08—0B Address of lock to be released 

OC—OF CRA lock account word (CRALKACT; see step 12 on page 79) 
10-13 Address of the issuer of the TPUNLOCK macro 

14-1B Lockword pointed to by address in bytes 08—0B 

1C-1F Request parameter header (RPH) Address. 
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UP Entry for User Application Program Post 


Entry: 
VIT Option: 
Event: 


UP 
API 
User application program post 


VIT Processing Module: ISTRACAP 
Control is Returned to: ISTAICPT or ISTAPCSX 


Applies to: 


This trace record provides the RPL information that VTAM passes to the application 
program. The RPL information and the API TPIO request record (Alin or |[On) show 
VTAM activity for a given API request. 


See “RPL-Based Macroinstruction Errors and Special Conditions” in VTAM Pro- 
gramming for a description of the RPL return codes. 


If this entry is associated with an event failure (that is, the return code is non-zero), 
this entry will be generated whether or not the API option is in effect. It is treated 
as an exception condition, and is always traced, regardless of the VIT options spec- 
ified, if the VIT is active. 


<A Om 


Byte (hex) 
00-01 
02 


03 
04 


810  VTAM V4R2 Diagnosis 


O/O/O/O/O/O/O/O/O/O/O/O;O;O;O;O; 1A) T;LPLiLpA;LpLp1p1plylsyajajqy.1 
0)1/213)4/5/6)7/8/9}A;BiC/DIE| F/O} 1)/2)3)4/5)6)7;8/9/A|BiCi|DIE|F 


E}I}R]F]F)RPL EXIT OR) RPL RPL CID RPL 
X D}D} ADDRESS | ECB AREA RLEN OR 0 FDBK2 
T B}B ADDRESS 

D 2}3 

S 


OO az- 


Contents 

Record ID: C'UP' 

RPL request type (RPLREQ) 

X'15' SETLOGON 

X'16' SIMLOGON 

X'17' OPNDST 

X'19' CHANGE 

X'1A' INQUIRE 

X'1B' INTRPRET 

X'1F' CLSDST 

X'22' SEND 

X'23' RECEIVE 

X'24' RESETSR 

X'25' SESSIONC 

X'27' SENDCMD 

X'28' RCVCMD 

X'29' REQSESS 

X'2A' OPNSEC 

X'2C' TERMSESS 

Exit definition (RPLEXTDS) 

ID is one of the following: 

¢ Primary address space ID 
This field is zero if the ID is greater than X'FF'. 

¢ Machine ID and Task ID 
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05 
06 


07 


08-0B 
OC-OF 
10-13 
14-17 
18-1B 
1C-1F 


UP 


e Task ID 
Return code (RPLRTNCD) (See “RPL-Based Macroinstruction Errors 
and Special Conditions” in VTAM Programming.) 
Feedback code (RPLFDB2) (See “RPL-Based Macroinstruction Errors 
and Special Conditions” in VTAM Programming.) 
Feedback data flag (RPLFDB3) (See “RPL-Based Macroinstruction 
Errors and Special Conditions” in VTAM Programming under INQUIRE 
macro with OPTCD=APPSTAT.) 
RPL address 
Exit address or ECB address 
RPL data area pointer (RPLAREA) 
Record length (RPLRLEN) 
CID from NIB or from RPL (RPLARG), or zero 
Second RPL feedback area — Sense code (RPLFDBK2). 
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VCC1 Entry for CNCB Queued (Part 1) 


Entry: vcCc1 
VIT Option: VCNS 
Event: CNCB queued (Part 1) 


VIT Processing Module: ISTRACNS 


Applies to: 


The VCC1 trace record is written when a CNS protocol control block (CNCB) is 
queued between CNS and LSA components or between CNS and CNSMAP. 


The VCC2 trace record displays data contained in the CNCB. 


O/O/O/O/O;/O/O;O/O/O;O;O;O;O/O;O; 1/1) 1/1] 1pAylpLiLjapa_j~ls)ayis1j1 
0)1)2)3)4)5)6)7/8)9;A|B)C)D)E} FiO} 1)2)3)4)/5)6)7/8) 9; A|BiC)DIE|F 


vcCcl CiS|}C|MAJOR |CNCB REQSTNG| 12 BYTES OF CNCB DATA 
B}T}C} CONTROL | ADDRESS | MODULE 
| A|0| BLOCK 
T}D}| ADDRESS 
EVE 


Byte (hex) Contents 
00-03 Record ID: C'VCC1' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
05 Control block identifier 
X'OB' ISTVLNCB 
X'7B' ISTRIB 


06 Process state of the contro! block processing the dequeued work 
element: 
LSNCB states when CBID=X'0B' (ISTVLNCB) 
X'00' Reset 
X'01' Pending active 
X'02' Active without application logged on to line 
X'03' Active with application logged on to line 
X'04' Pending inactive phase 1 | 
X'05' Pending inactive phase 2 
X'06' Pending inactive phase 3 
X'07' Blocked 
States when CBID=X'7B' (ISTRIB) 
X'00' Idle 
X'01' Logon in progress 
X'02' Active 
X'03' Logoff in progress 
X'04' DACTLINK in progress 
X'05' Forced termination in progress 
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07 CNCB primitive code 
X'01' CNS_INQUIRE_REQUEST 
X'02' CNS_INQUIRE_CONFIRM 
X'03' CNS_LOGON_REQUEST 
X'04' CNS_LOGON_CONFIRM 
X'05' CNS_LOGOFF_REQUEST 
X'06' CNS_LOGOFF_CONFIRM 
X'07' CNS_LOGOFF_RESPONSE 
X'08' CNS_LOGOFF_INDICATION 
X'09' CNS_CLOSEACB_REQUEST 
X'OA' CNS_CLOSEACB_CONFIRM 
X'OB' CNS_CLOSEACB_COMPLETION_INDICATION 


08—OB Address of the major control block 
OC—OF CNCB address 
10-13 Requesting module abbreviated name 


14-1F First 12 bytes of CNCB data. 
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vec2 Entry for CNCB Queued (Part 2) 


Entry: vcc2 

VIT Option: VCNS 

Event: CNCB queued (Part 2) 
VIT Processing Module: ISTRACNS 

Applies to: 


This trace record is a continuation of the VCC1 trace record. Up to two VCC2 
trace records might follow a VCC1 trace record, depending on the length of the 
primitive that is traced. 


O/O/O;O/O/O;O;O;O;O;O;O;O;O; OO; 1/1; T;DPL;LpLy1jiyljp2ijtjayi}i)1 
0} 1)2)3)4/5/6)7|8)9;A|/B) CDE} F/O) 1)2)3)4) 5/6) 7) 8,9; A|BiC}D|E|F 
vCC2 UP TO 28 BYTES OF ADDITIONAL CNCB DATA 


Byte (hex) Contents 
00-03 Record ID: C'VCC2' 
04—-1F Up to 28 bytes of additional CNCB data. 
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VCDQ 


VCDQ Entry for Work Element Dequeued 


Entry: 

VIT Option: 

Event: 

VIT Processing Module: 
Control is Returned to: 


Applies to: 


VCDQ 

VCNS 

Work element dequeued 
ISTRACNS 


Module invoking the INTRACE macro that caused the 


record to be produced. 


This trace record is written whenever a work element is dequeued for processing. 
The VCDQ trace record identifies the work element being dequeued. 


maAaY>s 
oH 


Byte (hex) Contents 
00-03 


0/0/0)0/0)010)0/0)0;0)/0/0/0/O)0) 1) 1) 1) 1) 2) 1) 1) 1] 1) 1)1;2)2j2)2)1 
0/1)2)3)4)5)6)7/8)9|A}B/C}DJE}F)0}1)2)3)4)5|6)7/8|9;A|B)C|D/E|F 


VCDQ |I}S/C}W} WORK 
D K} ELEMENT] OR OQ 
TYPE 


RU TYPE} WORK 
ELEMENT | ADDRESS 


RPH 
ADDRESS 


Record ID: C'VCDQ' 


04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
~~ 05 Process state of the associated connection or of the control block proc- 
essing the dequeued work element: 


States when CBID=X'0B' (ISTVLNCB) 


X'00' 
X'10' 
X'20' 
X'30' 


Reset state 
ACTLINK pending 
Active state 
DACTLINK pending 


States when CBID=X'0C' (ISTPCLCB) 


X'00' 
X'01! 
X'02' 
X'03' 
X'04' 


Reset 

Logon complete 

Logon pending 

Logoff pending 

Adapter termination pending 


States when CBID=X'25' (ISTVCCB) 


X'01' 
X'02! 
X'03' 
X'04' 
X'05' 
X'06! 
X'07' 
X'11' 
X'12' 
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P1 Ready 

P2 DTE waiting 

P3 DCE waiting 

P4 Data transfer 

P5 Call collision 

P6 DTE clear request 
P7 DCE clear indication 
Di Flow control ready 
D2 DTE reset request 
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VCDQ 


06 


07 
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X'13' D3 DCE reset indication 
X'21' 11 No interrupt pending 
X'22! l2 DTE interrupt pending 
X'31' E1 No error reset 

X'32' ER CNS error reset 
X'33'! CF CNS cancel forward 
States when CBID=X'66' (ISTCAB) 
X'00! Idle 

X'01' Connect requested 
X'02! Connect indicated 

X'03' Flow control ready 
X'04' Error reset 

X'05' Cancel hold 

X'06' Hold purge 

X'07' Reset requested 

X'08' Reset indicated 

X'09! Error disconnect 

X'OA' Cleanup 

X'OB' Disconnect requested 
X'0C' Disconnect indicated 
X'OD' Pending error disconnect 


States when CBID=X'6B' (ISTCAR) 
No states are traced when ISTCAR is the major control block. 
States when CBID=X'7B' (ISTRIB) 


X'00! 
X'01' 
X'02' 
X'03' 


X04! . 


X'05' 


Idle 

Logon in progress 

Active | 

Logoff in progress 

DACTLINK in progress 
Forced termination in progress 


Control block identifier 


X'OB' 
X'OC' 
X'25' 
X'66! 
X'6B' 
X'7B' 


ISTVLNCB 
ISTPCLCB 
ISTVCCB 
ISTCAB 
ISTCAR 
ISTRIB 


If work element is an ‘RPL’ (see bytes 08-0B) 


X'08' CONTROL=INQUIRE 
X'10' CONTROL=LOGON 
X'14' CONTROL=TEST 
X'18' CONTROL=XID 
X'20' CONTROL=LOGOFF 
X'30' CONTROL=READ 
X'40' CONTROL=STATUS 
X'50' CONTROL=SET 
X'60' CONTROL=OPEN 
X'70' CONTROL=CLOSE 
X'80' CONTROL=SEND 
X'90' CONTROL=SUSPEND 
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07 


X'A0' 
X'BO! 
X'CO' 
X'DO' 
X'E0! 
X'FO! 
X'FC! 


VCDQ 


CONTROL=RESUME 
CONTROL=EXPEDITE 
CONTROL=CHECK 
CONTROL=RESET 
CONTROL=SETCPARM 
CONTROL=RECEIVE 
CONTROL=REPLY 


lf work element is a ‘PICB’ (see bytes 08-0B) 


X'01' 
X'02' 
X'03' 
X'05' 
X'06' 
X'07! 
X'08' 
X'09' 
X'0A' 
X'0B' 
X'0C' 
X'0D! 
X'11' 
X'12!' 
X'13' 
X'14! 
X'15' 
X'16' 
X'17' 
X'18' 
X'19' 
X'1A' 
X'1B' 
X'21! 
X'22' 
X'23' 
X'24' 
X'25' 
X'31' 
X'32' 
X'33' 
X'34' 
X'35' 
X'36' 
X'37!' 
X'42' 
X'53' 
X'54! 
X'55' 
X'56' 
X'57' 
X'62' 
X'63' 
X'71' 
X'72' 
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LOGON_REQUEST 
LOGON_CONFIRM 
LOGOFF_REQUEST 
CNS_LOGON_REQUEST 
CNS_LOGON_CONFIRM 
CNS_LOGOFF_REQUEST 
CNS_LOGOFF_CONFIRM 
CNS_LOGOFF_RESPONSE 
CNS_LOGOFF_INDICATION 
CNS_CLOSEACB_REQUEST 
CNS_CLOSEACB_CONFIRM 
CNS_CLOSEACB_COMPLETION_INDICATION 
CONNECT_REQUEST 
CONNECT_CONFIRM 
CONNECT_ACCEPT 
CONNECT_INDICAT 
DISCONNECT_REQUEST 
DISCONNECT_INDICAT 
DISCONNECT_CONFIRM 
ERROR_DISCONNECT_INDICAT 
RESTART_INDICAT 

CNS_CLEAR | 
ERROR_DISCONNECT_INDICATION (TIMER) 
RESET_REQUEST 
RESET_CONFIRM 

RESET_ACCEPT 

RESET_INDICAT 
ERROR_RESET_INDICAT 
DATA_OUT (LEVEL1) 

DATA_IN (LEVEL1) 

DATA_OUT (LEVEL2) 

DATA_IN (LEVEL2) 
INTERRUPT_OUT 
INTERRUPT_CONFIRM 
INTERRUPT_INDICATION 
STATUS_INDICAT FINAL TERMINAT 
SUSPEND_REQUEST 
RESUME_REQUEST 

RNR_IN 

RR_IN 

ROTATE 

TIMER_EVENT 
RESTART_VC_TRIGGER 
RESET_PENDING_TRIGGER 
RESET_COMPLETE_TRIGGER 
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X'73' | CLEAR_PENDING_TRIGGER 
X'74'  CLEAR_COMPLETE_TRIGGER 
X'75'  CALL_PENDING_TRIGGER 
X'76' | CALL_COMPLETE_TRIGGER 
X'77'. _ INTERRUPT_PENDING_TRIGGER 
X'78' | ERROR_RESET_TRIGGER 

X'79' | ERROR_DISCONNECT_TRIGGER 
X'82'  PACKET_IN 

X'91' TERMINATE_PORT 

X'EO' = CNS_NMVT 

X'FOo'  READ_REQ 

X'F1' | READ_CONFIRM 

X'F2' — STATUS_PHYSICAL_REQUEST 
X'F3' | STATUS_PHYSICAL_CONFIRM 
X'F4' STATUS_VIRTUAL_REQ 

X'F5'  — STATUS_VIRTUAL_CONFIRM 


If work element is a ‘CNCB’ (see bytes 08-0B) 


X'01' CNS_INQUIRE_REQUEST 
X'02' CNS_INQUIRE_CONFIRM 
X'03' CNS_LOGON_REQUEST 
X'04' CNS_LOGON_CONFIRM 
X'05' CNS_LOGOFF_REQUEST 
X'06' CNS_LOGOFF_CONFIRM 
X'07' CNS_LOGOFF_RESPONSE 
X'08' CNS_LOGOFF_INDICATION 
X'09' CNS_CLOSEACB_REQUEST 
X'0A' CNS_CLOSEACB_CONFIRM 
X'OB' CNS_CLOSEACB_COMPLETION_INDICATION 


08—OB Work element type: 
C'CNCB' CNCB — 
C'RPL' RPL 
C'PICB' PICB 
C'RUPE' RUPE 
C'VCCB' VCCB 


C'CAB' CAB 
C'RIB' RIB 
C'RPH' RPH 
C'TSCB' TSCB 


C'UECB' UECB 
C'?22?' None of the above 
OC-—OF If work element is a ‘RUPE’, one of the ron: otherwise, zero 
X'0801020A' ACTLINK 
X'0801020B' DACTLINK 
10-13 Work element address 
14-17 If work element is ‘PICB’, CAB address; otherwise, zero 
18-1B Zero | 
1C-—1F Request parameter header (RPH) address. 
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VCP1 Entry for PICB Queued (Part 1) 


Entry: 

VIT Option: 

Event: 

VIT Processing Module: 
Control is Returned to: 


Applies to: 


VCP1 

VCNS 

PICB queued (Part 1) 
ISTRACNS 


VCP1 


Modules invoking the INTRACE macro that caused the 


record to be produced 


This trace record is written whenever packet-level interface control blocks (PICBs) 
are queued between components. The VCP2 trace record displays data contained 


in the PICB. 


S}C 


Byte (hex) Contents 
00—03 
04 


05 


-folojolelejejololofojejajolejeje!1}1fafaj1ja/aj2j2/2/ajaja}ajafi 
0) 1)2)3)4/5)6)7/8)/9j)A)BIC}D)E} F/O) 1)2/3)415)6)7)8/9;A|BIC|DIE|F 


FORMAT |PICB CAB CONT L 
DEPEND | ADDRESS| ADDRESS | POINTER; E 
DATA N 


Record ID: C'VCP1' 
Machine ID and Task ID 
Process state of associated connection or of control block process 
queuing PICB 


States when CBID=X'0B' (ISTVLNCB) 


X'00' 
X'10! 
X'20! 
X'30' 


Reset state 
ACTLINK pending 
Active state 
DACTLINK pending 


States when CBID=X'0C' (ISTPCLCB) 


X'00' 
X'01! 
X'02! 
X'03' 
X'04! 


Reset 

Logon complete 

Logon pending 

Logoff pending 

Adapter termination pending 


States when CBID=X'25' (ISTVCCB) 


X'01' 
X'02' 
X'03' 
X'04' 
X'05' 
X'06! 
X'07' 
X'11! 
X'12!' 
X'13! 
~X'21' 
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P1 Ready 

P2 DTE waiting 

P3 DCE waiting 

P4 Data transfer 

P5 Call collision 

P6 DTE clear request 
P7 DCE clear indication 
D1 Flow control ready 
D2 DTE reset request 
D3 DCE reset indication 
11 No interrupt pending 
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VCP1 


06 


07 
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l2 DTE interrupt pending 
E1 No error reset 

ER CNS error reset 

CF CNS cancel forward 


States when CBID=X'66' (ISTCAB) 


X'00' 
X'01' 
X'02' 
X'03! 
X'04! 
X'05! 
X'06' 
X'07' 
X'08'! 
X'09' 
X'0A' 
X'O0B' 
X'0C' 
X'O0D! 


Idle 

Connect request 
Connect indicated 
Flow control ready 
Error reset 

Cancel hold 

Hold purge 

Reset requested 
Reset indicated 

Error disconnect 
Cleanup 

Disconnect requested 
Disconnect indicated 
Pending error disconnect 


States when CBID=X'6B' (ISTCAR) 
No states are traced when ISTCAR is the major control block. 
States when CBID=X'7B' (ISTRIB) 


X'00! 
X'01' 
X'02! 
X'03! 
X'04! 
X'05! 


Idle 
Logon in progress 
Active 


_ Logoff in progress 


DACTLINK in progress 
Forced termination in progress 


Control block identifier 


X'0B' 
X'0C' 
X'25' 
X'66' 
X'6B' 
X'7B! 


PICB type 


X'01' 
X'02' 
X'03' 
X'05' 
X'06' 
X'07' 
X'08' 
X'09' 
X'0A' 
X'OB' 


~X'0C' 
X'OD' 


ae 
X'12! 


ISTVLNCB 
ISTPCLCB 
ISTVCCB 
ISTCAB 
ISTCAR 
ISTRIB 


LOGON_REQUEST 
LOGON_CONFIRM 
LOGOFF_REQUEST 
CNS_LOGON_REQUEST 
CNS_LOGON_CONFIRM 
CNS_LOGOFF_REQUEST 
CNS_LOGOFF_CONFIRM 
CNS_LOGOFF_RESPONSE 


~CNS_LOGOFF_INDICATION 


CNS_CLOSEACB_REQUEST 
CNS_CLOSEACB_CONFIRM 
CNS_CLOSEACB_COMPLETION_INDICATION 
CONNECT_REQUEST 

CONNECT_CONFIRM 
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08 
09 


X'13' 
X'14' 
X'15' 
X'16' 
X'17' 
X'18' 
X'19' 
X'1A' 
X'1B' 
X'21' 
X'22' 
X'23' 
X'24' 
X'25' 
X'31' 
X'32' 
X'33' 
X'34'! 
X'35' 
X'36' 
X'37' 
X'42' 
X'53! 
X'54!' 
X'55' 
X'56' 
X'57' 
X'62' 
X'63' 
X'71! 
X'72' 
X'73! 
X'74! 
X'75' 
X'76! 
X'77T' 
X'78' 
X'79' 
X'82' 
X'91! 
X'E0O' 
X'FO' 
X'F1' 
X'F2! 
X'F3! 
X'F4! 
X'FS' 


CONNECT_ACCEPT 
CONNECT_INDICAT 
DISCONNECT_REQUEST 
DISCONNECT_INDICAT 
DISCONNECT_CONFIRM 
ERROR_DISCONNECT_INDICAT 
RESTART_INDICAT 

CNS_CLEAR | 
ERROR_DISCONNECT_INDICATION (TIMER) 
RESET_REQUEST 
RESET_CONFIRM 

RESET ACCEPT 
RESET_INDICAT 
ERROR_RESET_INDICAT 
DATA_OUT (LEVEL1) 

DATA_IN (LEVEL1) 

DATA_OUT (LEVEL2) 

DATA_IN (LEVEL2) 
INTERRUPT_OUT 
INTERRUPT_CONFIRM 
INTERRUPT_INDICATION 
STATUS_INDICAT_FINAL_TERMINAT 
SUSPEND_REQUEST 
RESUME_REQUEST 

RNR_IN 

RR_IN 

ROTATE 

TIMER_EVENT 
RESTART_VC_TRIGGER 
RESET_PENDING_TRIGGER 
RESET_COMPLETE_TRIGGER 
CLEAR_PENDING_TRIGGER . 
CLEAR_COMPLETE_TRIGGER 
CALL_PENDING_TRIGGER 
CALL_COMPLETE_TRIGGER 
INTERRUPT_PENDING_TRIGGER 
ERROR_RESET_TRIGGER 
ERROR_DISCONNECT_TRIGGER 
PACKET_IN 

TERMINATE_PORT 

CNS_NMVT 

READ_REQ 

READ_CONFIRM 
STATUS_PHYSICAL_REQUEST 
STATUS_PHYSICAL_CONFIRM 
STATUS_VIRTUAL_REQ 
STATUS_VIRTUAL_CONFIRM 


PICB sequence number 
PICB CNS flags 


Bit 
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Meaning 

Qualified data indicator 
Delivery confirmation requested 
Delivery confirmed 
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.-1 .... More data indicator 
... 000. PICB format 0 
... 001.  #PICB format 1 
... 010.  PICB format 2 
.-. 011. PICB format 3 
.-.-- 100. PICB format 4 
Seay See 1 No disconnect confirmation allowed to CNS 
OA-0B Zero 
OC-OF For PICB format 1, PICB RIB address 
OC—OF For PICB format 2, PICB connection ID 
OC-—OF For PICB formats 3 and 4, PICB major and minor return codes 
10-13 PICB address 
14-17 PICB CAB address 
18-1B PICB continuation pointer 
1C-—1D PICB data length including continuation PICBs 
1E-—1F Zero. 
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VCP2 Entry for PICB Queued (Part 2) 


Entry: VCP2 

VIT Option: VCNS 

Event: PICB queued (Part 2) 

VIT Processing Module: ISTRACNS 

Control is Returned to: Modules invoking the INTRACE macro that caused the 
record to be produced 

Applies to: 


This trace record is a continuation of the VCP1 trace record. This record is written 
only when the PICB includes data. 
1 


0/0/0/0/0)0)0)0/0/0/0)0/0/0)O)O) 1) 171) 2) 2)12)1) 1) 1)1)2)1)1)1)1 
0) 1)2)3/4)5)6)7/8/9/A|BiC|D/E}F)0)1)2/3}4/5)6)7|8|/9;A|BiC|DIE|F 
VCP2 DATA FIELD 


Byte (hex) Contents 
00-03 Record ID: C'VCP2' 
04—1F Twenty-eight bytes of PICB data. 
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VPST Entry for VPOST Macro 


Entry: VPST 

VIT Option: PSS 

Event: VPOST macro 

VIT Processing Module: ISTRACPS 

Control is Returned to: Module invoking the INTRACE macro that caused the 
record to be produced. 

Applies to: 


This trace record is written when a VTAM module issues a VPOST macro. The 
VPOST macro generates a system POST event. 


0}0/0)0)0)0/0)0/0)0)0)0;0;O;O)O) 1) 1; 1) 2) 1) 2] 1) 1]1jijajij.yi}1)i 
0} 1)2)3/4/5/6)7/8)9;A/BiC)/DJE} F/O} 1)2/3/4/5)6)7)8)9;A;BiC/DIE|F 


VPST jI ASCB ECB COMPLTE) ISSUER 
D ADDRESS | ADDRESS 
OR 0 


Byte (hex) Contents 
00-03 Record ID: C'VPST' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
¢ Task ID 
05-07 Zero 
08-0B Address of the ASCB or 0 
OC-—OF Address of the ECB being posted 
10-13 Zero 
14-17 Completion code or 0 
18-1B Address of the issuer of the VPOST macro 
1C-1F Zero. 
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VRSM Entry for Resume after VWAIT 


Entry: VRSM 

VIT Option: PSS 

Event: VWAIT macro 
VIT Processing Module: ISTRACPS 
Applies to: 


This trace record is written when VTAM resumes control following a system WAIT 
event generated by the VIAM VWAIT macro. 


OO;/O;O/O;O;O/O/O;O/O/O/O/O;O;O; 1,1) 1; 1) 1jLylpLy2ypajayljiji)iji 
0}1/2)3)4)/5/6)7/8)9|A|BIC|DIE| F/O) 1)2)3)4)5)6/7 8/9) A,B) C DIE} F 


VRSM ECB ISSUER 
ADDRESS ADDRESS 


Byte (hex) Contents 
00—03 Record ID: C'VRSM' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 
05-0B Zero 
OC-OF Address of the ECB that was posted 
10-17 Zero 
18-1B Address of the code that is resuming execution 
1C-1F Zero. 
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VTAL Entry for Allocate Storage 


Entry: _ VTAL 
VIT Option: SMS 
Event: Allocate storage 


VIT Processing Module: ISTRACSM 
Control is Returned to: _ ISTORMVA 
| ISTORAVF 
ISTOREAF 


Applies to: 
This trace record provides the status of each VTALLOC request issued by VTAM 
components. 


If this entry is associated with an event failure (that is, the return code is non-zero), 

this entry will be generated whether or not the SMS option is in effect. It is treated 

as an exception condition and is always traced, regardless of the VIT options speci- 
fied, if the VIT is active. 


Fi eis He Hib aHNE sHbE AHHE RHEE 
db WHEE ane RAE ARBRE AB RE 


Byte (hex) Contents 
00-03 Record ID: C'VTAL' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID 
¢ Task ID 


05 Flags 
Bit 
Meaning 
Oks: dete FREED(EXPLICIT) storage request 
A cia: Atstes FREED(TASK) or FREED(JSTASK) storage request 


06—07 Zero 
08—0B Address of area allocated 


OC—OF ID 
Subpool number of the area allocated 
Buffer pool ID 
_ Area where storage is allocated 
SGA System GETVIS area 
PGU Private GETVIS area in user partition 
PGV Private GETVIS area in VTAM partition 


10-13 Address of the issuer of the VTALLOC macro 
14-17 Length of area allocated | 
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18-1B If the VTALLOC macro is issued by a utility routine, this location con- 
tains the address of the issuer of the utility routine. 
lf the VTALLOC macro is not issued by a utility routine, this location 
contains zero. 

1C-1F VTALLOC return code. 
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-VIFR Entry for Free a 


Entry: VTFR 
VIT Option: SMS 
Event: Free storage 


VIT Processing Module: ISTRACSM 

Control is Returned to: ISTORMVF 
ISTORAVF 
ISTOREAF 


Applies to: 
This trace record provides the status of each VTFREE request issued by VTAM 
componenis. 


HEE AEE dee ane Ape Hac 
HHH AE dre HHHE AHAB ARE 


Byte (hex) Contents 
00-03 Record ID: C'VTFR' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
¢ Machine ID and Task ID 
¢ Task ID 
05-07 Zero | 
08—0B Address of area to be freed 
OC—OF Number or ID | 
Subpool number of the area allocated 
Buffer pool ID 
10-13 Address of the issuer of the VTFREE macro 
14-17 Length of area to be freed 
18-1B lf the VITFREE macro is issued by a utility routine, this location con- 
tains the address of the issuer of the utility routine. 
lf the VITFREE macro is not issued by a utility routine, this location ¢ con- 
tains zero. 
1C—1F Zero. 
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VWAI Entry for VWAIT Macro 


Entry: VWAI 
VIT Option: PSS 
Event: VWAIT macro 


VIT Processing Module: ISTRACPS 
Control is Returned to: Module invoking the INTRACE macro that caused the 
record to be produced. 


Applies to: 


This trace record is written when a VTAM module issues a VWAIT macro. The 
VWAIT macro generates a system WAIT event. 


If the “last address in ECB list” field is not zero, then this is a wait on an ECB list. 
Note that an ECB list is a list of the addresses of ECBs, not a list of ECBs. 


O/O/O/O/O/O/O;O/O;O/O;O,O;O;O;O; Ti LiA;TpLPLPA;Apaplp~lyTidpayay. 
0}1)2)/3)4)5)6)/7/8j9/A;BiC|DJE} FIO) 1)2)3)4/5)6)7)8)9|A|BiC|D/E|F 


ADDRESS | ADDRESS 


ADDRESS|OR 0 


Byte (hex) Contents 
00-03 Record ID: C'VWAI' 
04 ID is one of the following: | 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 
05-0B Zero | 
OC-—OF Address of the ECB that is being waited on, or (if the next field is non- 
zero) the address of an ECB list. 
10-13 Address of the last pointer in an ECB list, or 0. If this field is 0, it 
implies that the previous field points to an ECB instead of an ECB list. 
14-17 Zero 
18-1B Address of the issuer of the VWAIT macro 
1C-—1F Zero. 
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WAIT Entry for TPWAIT Macro 


Entry: WAIT 
VIT Option: PSS 
‘Event: TPWAIT macro 


VIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCTW 


Applies to: 


This trace record identifies an RPH that has been suspended to wait for some 
VTAM resource. This entry might be used with the entry immediately preceding it 
in the table to determine whether the wait is for storage or for a lock. If the pre- 
ceding entry is fora REQSTORE, a waiting-for-storage condition may exist. If the 
preceding entry is for a lock request, the wait can be caused by that request. 
However, VTAM frequently uses a TPWAIT/TPPOST to synchronize intercompo- 
nent functions. Therefore, the TPWAIT entry does not necessarily identify an 
unusual condition. | 


O/O/O;O/O/O;O/O;O;O;O/O;OO;O;O; A A;T;LPLiLi1p1pa_pdyayayrjiiiii 
0} 1)2)3)4)5)6)7)/8/9|/A/BiC)DJE} FIO) 1)2)3)4/5)6)7;/8/9)A| B/C; D)E|F 


F |PST | PAB RETURN |WORK EL|MODULE | RPH 
L |} ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C'WAIT' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 


05 Zero 
06 PAB flag field (PABFLAGS) 
Bit Meaning 
L346. 4555 PAB is unconditionally scheduled. 
.1.. .... | PAB closedown is in progress. 
..l. .... PAB is synchronous. 
.-1 .... PAB extension is present. 
. 1... Do not dequeue work element. 
.1.. Do not detach the RPH. 
.... «.l. Indicates a very extended PAB. 
srstienen Swidse 1 Indicates a slightly extended PAB. 
07 PAB flag field (PABFLGS1) 
Bit | Meaning 
Led, coon Switch the PST address of this PAB's major control block 


to the new PST address contained in DYPNWPST. 
.l.. .... | This PAB has a data space extension. 
..l. .... | This PAB’s major control block is an FMCB. 
..1 .... | PABcan be referenced in PSW disable mode. 
. 1... PAB is persistent. 
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08—0B 
O0C—OF 
10-13 
14-17 


18-1B 


1C-1F 


WAIT 


1... APSTERM/APSINIT FMCB during PAB dispatch. 
Bae es xx Reserved. 
PST address 
PAB address 
Address of the issuer of the TPWAIT macro 
PAB work element queue or next dispatchable queue level for a very 
extended PAB 
Module name abbreviation (bytes 4, 5, 7, and 8 of the name of the next 
module to get control), PAB DVT address (high order bit of X'18' = 0), 
function, or process. 
Request parameter header (RPH) Address. 
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XID Entry for Exchange ID (Part 1) 


Entry: XID 
VIT Option: | ClO 
Event: Exchange ID (Part 1) 


VIT Processing Module: ISTRACCI 
Control is Returned to: ISTTSCCU or ISTTSC8X 


Applies to: 
This trace record contains information about inbound or outbound exchange ID 
processing. 


OO; O;O;O;O/O;O;O/O/O/O/O/O;O;O;T LiL; T;ApTpdyayaf{lplj1jij1j1)1 
0} 1/2)/3)4)5)6)7/8)/9;A;By/C/DJ EJ F/O} 1)2)3)4)5)6)7)8;/9;/A;B/C| DIE; F 
XIDI |NCB XID DATA 

XIDO |ADDRESS|ADDRESS 


Byte (hex) Contents 
00-03 Record ID: 
C'XIDI' for inbound XID 
C'XIDO' for outbound XID 
04-07 NCB address 
08—OB Boundary physical unit block (BPB) address or zero 
OC-—1F 20 bytes of XID data. 


832 VTAM V4R2 Diagnosis . | | LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” XID2 
Licensed Materials — Property of IBM 


XID2 Entry for Exchange ID (Part 2) 


Entry: XID2 

VIT Option: Clo 

Event: Exchange ID (Part 2) 
VIT Processing Module: ISTRACCI 

Applies to: 


This trace record is a continuation of the XID trace record. 
O/O/O/O/OO/O/O/O/O/O/O/OO;O;OLILILILI LILI LI LiL Li ay 1yi1j1j1)1 
OILI ZS 4 /5/6/7/B8 (9 AIBICIDIE/FIO;1/2;3;4/5(/61/7 (8/9; AIBIC{/DIE| F 
XID2 ADDITIONAL XID DATA 


Byte (hex) Contents 
00-03 Record ID: C'XID2' 
04—1F 28 bytes of additional XID data. 
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XPST Entry for TPSWPST Macro 


Entry: XPST 
VIT Option: PSS 
Event: TPSWPST macro 


VIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCSP 


Applies to: 


This trace record identifies a VTAM process (PAB) that is switching PSTs during 
termination of a task. Switching PSTs causes the PAB to be scheduled for dis- 
patch under the new PST. 


la 0/0/0 4HHE AH HE mlelali aAnE aHEE THEE 
2|3}4 aH HH HE Pala bale HAE HEE 


XPST PAB ISSR 
ADDRESS 


Byte (hex) Contents 
00-03 Record ID: 'XPST' 
04 ID is one of the following: 
e Primary address space ID 
This field is zero if the ID is greater than X'FF'. 
e Machine ID and Task ID 
e Task ID 


05 Zero 

06 PAB flag field (PABFLAGS) 
Bit Meaning 
dicta d: encees PAB is unconditionally scheduled. 
-1.. .... | PAB closedown is in progress. 
..1. .... PAB is synchronous. 


..1 .... PAB extension is present. 
. 1... Do not dequeue work element. 
.1.. | Do not detach the RPH. 
..l1. Indicates a very extended PAB. 


Satie Sahn 1 Indicates a slightly extended PAB. 
07 PAB flag field (PABFLGS1) 
Bit Meaning 
Pexe.6ae Switch the PST address of this PAB’s major control block 


to the new PST address contained in DYPNWPST. 
.1.. .... | This PAB has a data space extension. 
..l. .... | This PAB’s major control block is an FMCB. 
..1 .... PAB can be referenced in PSW disable mode. 
. 1... PAB is persistent. 

».e. -l.. ©APSTERM/APSINIT FMCB during PAB dispatch. 

te ee xx Zero. 
08—0B New PST address under which this PAB will now be dispatched 
OC-—OF PAB address 
10-13 Address of the issuer of the TPSWPST macro 
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14-17 PAB work element queue 
18-1B Module name abbreviation or PAB DVT address 
1C-1F Request parameter header (RPH) Address or zero. 
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Appendix B. Finding VITAM Buffer Pools (VM, VSE) © 


This appendix describes general procedures for locating VTAM buffer pools. 
Included are the following sections: 


e “Finding VTAM Buffer Pools (VM)” 
e “Finding VTAM Buffer Pools (VSE)” on page 839 
e “Relative Locations of VTAM Buffer Pools (VSE)” on page 842. 


Some types of problems may require that you collect and supply information for 
specific buffer pools. 


For information on solving storage problems on MVS, see “Storage Problem 
Procedure (MVS)” on page 105. 


Finding VTAM Buffer Pools (VM) 


Use the following procedure to find VTAM buffer pools and to determine whether 
any have used all their buffers. 


Dumps processed with PRTDUMP contain all the data necessary to use this proce- 
dure if VTAM control block formatting is requested. To determine what book con- 
tains more information on processing dumps using PRTDUMP, see Table 80 on 
page 1165. 


1. From the ATCVT, find the address of the buffer pool directory (BPDTY) in field 
ATCBPDA. 


2. From the BPDTY, find the address of the first buffer pool entry (BPENT) in field 
BPDENTRY. There are 9 BPENTs, one for each buffer pool; each is 10 hex 
bytes in length and contains the name of a buffer pool at hex offset 00, and the 
address of the buffer pool control block (BPCB) at hex offset 08. 


3. Find each BPCB. Each BPCB represents a buffer pool. 
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Example: Finding LPBUF (VM) 


(1) ATCVT 
Low storage 
location al a 


ARRAY of 
BPENTs 


PXBPXB 
’ PXBSTADR 


(9) 


(Expanded 
LPBUF buffer pool) 


Ce inst 


Note: Not every LPOO buffer 
contains a CRA. 


Figure 81. Relationships among Buffer Pool Control Blocks 


Use the following steps to find the large pageable buffer pool (LPBUF). LPBUF is 
the buffer pool that contains the CRAs and RPHs. Figure 81 shows the control 
block relationships involved in these steps. 


1. Find the ATCVT. The field ATCLCPTR points to the address of the ATCVT. 
ATCLCPTR is at low-storage location hex 200. 


The ATCVT is identified by release level at hex offset 00 in the ATCVT. For 
VTAM V4R2 the identifier is VA42 (X'E5C1F4F240404040'). 


2. From the ATCVT, find the address of the first buffer pool control block (BPCB) 
in field ISTBPCBA (BPDTY + X'2C'). 


3. There are 9 BPCBs, one for each buffer pool. Each BPCB is 248 bytes in 
length. The large pageable buffer pool (LPOO) is the third entry in the array of 
BPCBs. 
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4. The beginning address of the static portion of the LPOO buffer pool is at BPCB 
+ X'14'(BPCBADR1); the end of the static portion is pointed to by BPCB + 
X'18' (BPCBADR2). 


5. The first buffer begins at the address found in the BPCB + X'14' 
(BPCBADR1). To verify the correct buffer pool, hex offset 08 (BFPBCB) in 
each buffer should have the address of the BPCB found in step 3 on 
page 838. A buffer is allocated when the X'80' bit (BFPALLOC) at offset 
X'4' in each buffer is ON. 


6. To find the subsequent buffers, add hex 800 to the address of the previous 
buffer. Two buffers are on each 4K page of storage. 


When you reach the address in BPCB + X'18' (BPCBADR2), you have found 
the end of the LPOO buffer pool. 


7. To find LPOO buffer pool expansion areas, use the address of the pool exten- 
sion block (PXB) at BPCB + X'94' (BPCBBPXB). If the address is zero, there 
are no expansions; the buffer pool has not been expanded since VTAM was 
started. In this case, skip step 8 and 10. If there is an address, the buffer pool 
has been expanded dynamically and the expansions need to be examined; 
continue with the next step. 


8. Find the PXB, pointed to by BPCB + X'94' (BPCBBPXB). The PXB hex offset 
OC (PXBSTADR) is the beginning of the pool expansion area. If 
PXBSTADR=0, go to step 10. PXBs are not freed by VTAM; only the area 
containing buffers is freed. The length of the expansion area (BPCBEXLN) is 
found at BPCB + X'A8'. Add the length (BPCBEXLN) to the Seer address 
(PXBSTADR) for the end of the expansion area. 


9. Go through the buffers as directed before in steps 5 and 6, where the first 
buffer begins at PXBSTADR (instead of BPCBADR1) and the end of the exten- _ 
sion area is pointed to by PXBSTADR + BPCBEXLN (instead of BPCBADR2). 


10. Find the next PXB, pointed to by PXB + X'04' (PXBPXB). If PXBPXB<0, 
proceed as in step 9. If PXBPXB=0, there are no more expansion areas; the 
search is complete. 


Finding VTAM Buffer Pools (VSE) 


Use the following steps to find the buffer pools and determine whether any have 
used all of their available buffers. Figure 82 on page 840 shows the control blocks 
involved in these steps. 


1. Find the ATCVT. Its address is at low-storage location hex 408. 
If this low-storage location is not available in a dump, 
a. Find the SYSCOM pointer at lowcore X'80'. 
b. Find the AVT pointer at SYSCOM + X'60'. 
c. AVT + X'00' points to the ATCVT. 


The ATCVT is identified by release level at hex offset 00 in the ATCVT. For 
VTAM V4R2 the identifier is VS42 (X'E5E2F4F240404040'). 


2. The ATCVT is immediately preceded in storage by the buffer pool directory 
(BPDIR) and the fixed-length pool PCBs, which can be identified by the pool 
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IDs in EBCDIC. (‘Relative Locations of VTAM Buffer Pools (VSE)” shows the 
relative locations of the buffer pools.) 


ATCVT field ATCBPDA + X'414' also points to the BPDIR. 


ATCVT 


Hex 408 


ATCVT 


Buffer 


Hex 414/4BPDIR Hex 1 Pool || BFPFX 44 Flags) 
I 


BFPFX 8|4PCB 


Hex 0168 


Resume 
address 


ss aetna BFPFX'C 
eer ee rT 08/7Start of pool 
RPH Lg 


0C;*End of pool 


BPDIR RPH 10 


PCB for a 
buffer pool 


18|/Max. number of 
buffers used 


22| Buffer size 


24 buffers 


28|*First free 
buffer in pool 


eeoeoeoeosvee e828 @ 


30/*First 
queued RPH 


58 | TPXB 


60|Number of pool 
expansions 


68|Length of 
expansion area 


Figure 82. Relationships among Buffer Pool Control Blocks 
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Example: Finding LPBUF (VSE) 


Use the following steps to find the large pageable buffer pool (LPBUF) in VSE. 
LPBUF is the buffer pool that contains the CRA/RPHs. Figure 82 on page 840 
shows the control block relationships involved in these steps. (“Relative Locations 
of VTAM Buffer Pools (VSE)” on page 842 has more information on the location of 
VTAM buffer pools in VSE.) 


1. Find the ATCVT. 
a. Find the SYSCOM pointer at lowcore X'80'. 
b. Find the AVT pointer at SYSCOM + X'60'. 
c. AVT + X'00' points to the ATCVT. 


The ATCVT is identified by release level at hex offset 00 of the ATCVT. For 
VTAM V4R2 the identifier is VS42 (X'E5E2F4F240404040'). 


2. From the ATCVT find the address of the buffer pool directory (BPDIR) in field 
ATCBPDA (ATCVT + X'414'). 


_ 3. From the pointer at BPDIR + X'14', find the buffer pool control block (PCB) for 
the large pageable buffer pool (LP). At hex offset 08 in the PCB is the address 
of the start of the LP pool. 


4. To find the next buffer, add hex 550 to the address of the buffer prefix (BFPFX) 
of the previous buffer. Continue with this process until the end of the LP buffer 
pool (at the address in PCB + X'0C'). 


Each buffer (including the prefix) is 1360 (hex 550) bytes, and the buffers can 
cross page boundaries. The buffer size is also given in PCBBUFSZ (PCB + 
X'22'), 

The total number of buffers is given in PCBTOTNO (PCB + X'24'). 


5. To find the LP buffer pool expansion areas, use the address of the pool exten- 
sion block (PXB) at PCB + X'58'. If the address is zero, there are no expan- 
sions; the buffer pool has not been expanded since VTAM was started. In this 
case, skip steps 6 and 7. If there is an address, the buffer pool has been 
expanded dynamically and the expansions need to be examined; continue with 
the next step. 


6. Find the PXB, pointed to by PCB + X'58'. The PXB hex offset 0C 
(PXBSTADR) is the beginning of the pool expansion area. If PXBSTADR=0, go 
to step 7. PXBs are not freed by VTAM; only the area containing buffers is 
freed. The length of the expansion area (PCBEXLN) is found at PCB + X'68'. 
Add the length (PCBEXLN) to the starting address (PXBSTADR) for the end of 
the expansion area. 


7. Find the next PXB, pointed to by PXB + X'04' (PXBPXB). If PXBPXB=0, 
proceed as in step 6. If PXBPXB=0, there are no more expansion areas; the 
search is complete. 
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Relative Locations of VTAM Buffer Pools (VSE) 


To finda particular VTAM buffer pool in a VSE system, see the partition map in 
Figure 83 on page 843 and follow these steps: 


1. Find the ATCVT at low-storage location hex 408, if available, or from hex offset 
00 in the AVT. 


2. Find the buffer pool directory (BPDIR) from ATCVT + X'414' (ATCBPDA), or 
by subtracting hex 30 from the ATCVT address. 


3. Find the pool control blocks (PCBs) from the pointers in BPDIR, or by finding 
the EBCDIC pool ID preceding the BPDIR in the storage dump (for fixed-length 
pools only). 


For all buffer pools, the beginning and ending addresses of the initial pool extent 
are contained in the PCB at hex offsets 08 (PCBSTGA) and 0C (PCBSTGE), 
respectively. 


For fixed-length pools, the storage area may consist of one or more extents. The 
initial extent allocated when VTAM is started contains the number of buffers indi- 
cated as a Start parameter. Additional extents may be allocated if dynamic expan- 
sion is allowed for the pool. See “Buffer Pools” in the VITAM Network 
Implementation Guide for more information on buffer pool extents. 


To find the buffers in a fixed-length pool, start with the buffer prefix (BFPFX). 
BFPFxX is a prefix on all fixed-length VTAM buffers. It precedes the data portion of 
the buffer and identifies the buffer pool to which a buffer belongs. The BFPFX is 
X'3C' in length. The third word of BFPFX points to the PCB. To find other 
buffers, add to or subtract from the address of the current prefix the length of the 
buffer (contained in the PCB + X'22'(PCBBUFSZ)) plus 60 (hex 3C) for the prefix. 
If the new location does not contain a BFPFX pointing to the same PCB, you have 
reached the end of the pool. 


Use the count of buffers at PCB + X'24' (PCBTOTNO) to determine whether there 
are also expansion extents. Information about them is found in the PXB, which is 
chained from PCB + X'58' (PCBPXB). If that location is not equal to zero, and if 
the total buffer count at PCB + X'24' (PCBTOTNO) is greater than the number of 
buffers found in the initial extent, there are additional buffers pointed to by PXBs. 
Each PXB may point to a storage area. Examine location hex 0C (PXBSDADR) in 
the PXB. If that location is not equal to zero, it is the beginning address of the 
extent. The number of buffers is contained at PXB + X'16'(PXBTOTL). Examine 
the PXB chain pointer at hex 04 (PXBPXB) to find the next PXB, if any. 
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VTAMRP TCB 


Hex 60 


VTAMRP TID 
Hex 408) TATCVT 


Relative Locations of VTAM Buffer Pools (VSE) 
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Pageable modules 


VSE anchor 
table/VISTAB 


First page of 
load table 


Pageable modules 


Second page of 
load table 


Pageable modules 
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Size nnnk 
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Figure 83. Map of the VTAM Partition 
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FFST Probes 


Appendix C. First Failure Support Technology (FFST) Probes 


(MVS)(VM) 


This appendix contains the following sections: 


e “FFST Probe Index” 


e “FFST Probe Information” on page 846 
e “FFST Probe Naming Convention” on page 846 
e “FFST Probe Descriptions” on page 847. 


See “First Failure Support Technology (FFST) for VTAM (MVS) (VM)” on page 217 


for additional information. 


FFST Probe Index 


The following table provides an index of FFST probes in alphanumerical order by 


probe name: 


Table 36. FFST Probe Index 


Probe Name 


ISTCOCxx 
ISTCSCxx 
ISTDLCxx 
ISTDRCxx 
ISTFSCxx 


ISTIPCxx 


ISTMTCxx 
ISTNACxx 
ISTNSCxx 
ISTORCxx 
ISTRACxx 
ISTSCCxx 
ISTSLCxx 

ISTSSCxx 
ISTTRCxx 
ISTTSCxx 


Component 

Control Operator 
Configuration Services 
Dependent LU Server 
Directory Services 


Coupling Facility Services 
IP Network Access 


Management Services Transport 
Network Resource Management 
LU Network Services 

Storage Management 

Trace Services 

Session Services CP-CP 
Session Services LU-LU 
Session Services 

Topology and Routing Services 


Transmission Subsystem 
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“Control Operator Probes” on page 848 

“Configuration Services Probes” on page 847 
“Dependent LU Server Probes” on page 851 

“Directory Services Probes” on page 852 

“Coupling Facility Services Probes (MVS)” on page 849 


“IP Network Access Probes (MVS)” on page 859 


“Management Services Transport Probes” on page 860 
“Network Resource Management Probes” on page 861 
“LU Network Services Probes” on page 860 

“Storage Management Probes” on page 869 

“Trace Services Probes” on page 870 

“Session Services CP-CP Probes” on page 861 
“Session Services LU-LU Probes” on page 863 
“Session Services Probes” on page 861 

“Topology and Routing Services Probes” on page 869 


“Transmission Subsystem Probes” on page 870 
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FFST Probe Information 


When a VTAM FFST probe is triggered, an unexpected condition has occurred in 
the network. The process that received the condition might not complete normally. 
The VTAM program will attempt to recover from the unexpected condition and will 
continue processing subsequent requests. Recovery might not be possible for 
some system conditions and subsequent requests might fail, terminals might hang, 
and other abnormal conditions might occur. 


Dump data is collected to assist in identifying the source of the problem. The proc- 
essing element is freed and processing continues. If the probe triggers multiple 
times you might need to halt and restart VTAM. 


Contact the appropriate IBM Support Center and supply the service representative 
with the console listing that is written at the time of the error and the dump data 
produced by the probe. 


For information on using FFST dumps, see “First Failure Support Technology 
(FFST) for VTAM (MVS) (VM)” on page 217. 


FFST Probe Naming Convention 


The following table describes the naming convention for the FFST probe name. 
ISTRACO1 is used as an example. | 


Charac- Example Description 
ters . 
1,2,3 IST These characters represent the product identifier. For VTAM 


probes, these characters are IST. 


4,5 — RA These characters represent the VTAM component identifier. In — 
this example, RA is the component identifier for the Trace Ser- 
vices component. | 


C For VTAM probes, this character is usually C. 


7,8 01 These characters represent the probe identification number. 
This number is not duplicated. 
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FFST Probe Descriptions 


This section includes a table for each component that contains FFST probe 
instructions. The components are in alphabetical order, and the probes for each 
component are in alphanumerical order by probe name. “FFST Probe Index’ on 
page 845 provides an index of FFST probes in alphanumerical order by probe 
name. Each table in this section shows the probe name, the module that issues it, 
and whether the probe creates a full or minidump when triggered. 


“FFST Probe Index” on page 845 provides an index of FFST probes in alphanu- 


merical order by probe name. 


For information on using FFST dumps, see “First Failure Support Technology 
(FFST) for VTAM (MVS) (VM)” on page 217. 


Configuration Services Probes 


Table 37 (Page 1 of 2). FFST Probes for Configuration Services (ISTCSCxx) 


Probe Name Module Description Dump Type 
ISTCSCO1 ISTACCQ3 This probe detects request contact (REQCONT) errors Mini 

caused by an unrecognized CPNAME. It produces 

information about the failing request unit processing 

element (RUPE), request/response unit (RU), and vari- 

able work area (VWA). If available, the resource defi- 

nition table entry (RDTE) for the LINE and PU is also 

reported. | 
ISTCSC02 ISTCSCRC Resource registration failure was detected. Mini 
ISTCSCO3 ISTCSCRE Resource registration failure was detected. Mini 
ISTCSC04 ISTCSCRF Resource registration failure was detected. Mini 
ISTCSCO05 ISTCSCRJ Resource registration failure was detected. Mini 
ISTCSCO6 ISTCSCRK Resource registration failure was detected. Mini 
ISTCSCO7 ISTCSCRH Resource registration failure was detected. Mini 
ISTCSCO08 ISTACCDF Memory is freed inside an NCP causing a pointer that Full 

is not valid. Information produced by this probe con- 

tains the following: 

e The address of the resource definition table entry 
(RDTE) for the NCP 
e The unrecognized resource definition intermediate 
node (RIN) pointer 

ISTCSCO9 ISTDECQE The resource definition table entry (RDTE) for the Full 

dependent LU requester CDRSC was not found. 
ISTCSC10 ISTDECQD The resource definition table entry (RDTE) for the Full 

dependent LU requester CDRSC was not found. 
ISTCSC11 ISTDECP3 The resource definition table entry (RDTE) for the Full 

dependent LU requester CDRSC was not found. 
ISTCSC12 ISTDECP4 The resource definition table entry (RDTE) for the Full 

dependent LU requester CDRSC was not found. 
ISTCSC13 ISTDECQ4 A protocol violation was detected. Full 
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Table 37 (Page 2 of 2). FFST Probes for Configuration Services (ISTCSCxx) 


Probe Name Module | Description | Dump Type 
ISTCSC14 ISTDECQ4 A topology database update (TDU) error was detected. Full 
ISTCSC15 ISTACCQE An attempt to add the resource definition table entry Full 


(RDTE) for the DLUS-supported LU failed because the 
network address is already in use or was not properly 
freed by a previous user. Related pointer values are 
provided in the secondary symptom string. 


ISTCSC16 ISTDECLL The GETRDTE for the higher-level resource failed. Full 


Control Operator Probes 


Table 38 (Page 1 of 2). FFST Probes for Control Operator (ISTCOCxx) 
Probe Name Module Description Dump Type 
ISTCOCOT1 ISTCOCDL A suspended log mode is not found. Full 


Check the mode the application program specifies on 
the APPCCMD CONTROL=OPRCNTRL, 
QUALIFY=RESTORE macroinstruction. 


You can use the following VTAM dump functions to 
display advanced program-to-program communication 
(APPC)-related information: 


e APPLCONV 
e APPLMODE 
e APPMODAL 
e PARTNRLU. 


_ For information about these functions, see Chapter 7, 
_ “Using VTAM Dump Analysis Tools (MVS)” on 
page 237. 


ISTCOC02 ISTCOCSC A suspended log mode is not found. Full 


Check the mode the application program specifies on 
the APPCCMD CONTROL=OPRCNTRL, 
QUALIFY=RESTORE macroinstruction. 


You can use the following VTAM dump functions to 
display advanced program-to-program communication 
(APPC)-related information: 


e APPLCONV 
e APPLMODE 
e APPMODAL 
e PARTNRLU. 


For information about these functions, see Chapter 7, 
“Using VTAM Dump Analysis Tools (MVS)” on 
page 237. | 
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Table 38 (Page 2 of 2). FFST Probes for Control Operator (ISTCOCxx) 


Probe Name 


ISTCOCO3 


Module 
ISTCOCVR 


Description 
A suspended log mode is not found. 


Check the mode the application program specifies on 
the APPCCMD CONTROL=OPRCNTRL, 
QUALIFY=RESTORE macroinstruction. 


You can use the following VTAM dump functions to 
display advanced program-to-program communication 
(APPC)-related information: 


e APPLCONV 
e APPLMODE 
e APPMODAL 
e PARTNRLU. 


For information about these functions, see Chapter 7, 
“Using VTAM Dump Analysis Tools (MVS)” on 
page 237. | 


Coupling Facility Services Probes (MVS) 


Table 39 (Page 1 of 3). FFST Probes for Coupling Facility Services (ISTFSCxx) 


Probe Name 


Module 


Description 


FFST Probes 


Dump Type 
Full 


Dump Type 


ISTFSCOO 


ISTFSCO1 


ISTFSC02 


ISTFSCO3 


ISTFSCO4 


ISTFSCO5 


ISTFSCO6 


ISTFSCO7 


ISTFSCO8 


ISTFSUMT 


ISTFSNRT 


ISTFSNRT 
ISTFSNCF 
ISTFSUDC 
iors 
ISTFSURS 
ISTFSUUS 


ISTFSUFC 


An unexpected return code xxxx and 
reason code yyyy were returned for 
IXLLIST when VTAM attempted to move 
an entry to the end of a list. 


A work element that was not recognized by 
coupling facility services (CFS) was 
queued to the CFS connection services 
PAB. 


A work element was recognized by cou- 
pling facility services (CFS), but it con- 
tained incorrect information. 


An unexpected input was received for the 
current state of the connection finite state 
machine. 


An unexpected return code xxxx and 
reason code yyyy were returned for the 
IXLDISC macro. 


An unexpected return code xxxx and 
reason code yyyy were returned for the 
IXLREBLD macro. 


An unexpected return code xxxx and 
reason code yyyy were returned for the 
IXLEERSP macro. 


An unexpected return code xxxx and 
reason code yyyy were returned for the 
IXLUSYNC macro. 


An unexpected return code xxxx and 
reason code yyyy were returned for the 
IXLFORCE macro. 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 
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Table 39 (Page 2 of 3). FFST Probes for Coupling Facility Services (ISTFSCxx) 


Probe Name 


ISTFSCO9 


ISTFSCOA 


ISTFSCOB 


ISTFSCOC 


ISTFSCOD 


ISTFSCOE 


ISTFSC11 


ISTFSCTIA 


ISTFSC1B 


ISTFSC1C 


ISTFSC1D 


ISTFSC1E 


ISTFSC1F 


ISTFSC20 


Module 
ISTFSNCN 


ISTFSNCN 


ISTFSNCN 


ISTFSGLR 


ISTFSGRT 


ISTFSGG1 


ISTFSGRT 


ISTFSURL 


ISTFSUUL 


ISTFSUCL 


ISTFSUHT 


ISTFSKRT 


ISTFSKRT 


ISTFSKRT 
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Description 


An unexpected return code xxxx and 
reason code yyyy were returned for the 
IXLCONN macro. 


VTAM was connected to an unexpected 
structure type. 


The connection name returned in the 
IXLCONN answer area was not the name 
specified on IXLCONN. 


VTAM was not able to find a local generic 
mapping while rebuilding the coupling 
facility structure with local data. 


An unexpected input was received for the 
current state of the generic resource struc- 
ture finite state machine. 


VTAM made a counting error associated 
with a generic resource. 


VTAM has disconnected from the coupling 
facility structure ISTGENERIC because a 
timed process did not complete within the 
given time. 


An unexpected return code xxxx and 
reason code yyyy were returned for 
IXLLIST when VTAM attempted to read a 
list entry. 


An unexpected return code xxxx and 
reason code yyyy were returned for 
IXLLIST when VTAM attempted to update 
a list entry. 


An unexpected return code xxxx and 
reason code yyyy were returned for 
IXLLIST when VTAM attempted to create a 
list entry. 


An unexpected return code xxxx and 
reason code yyyy were returned for 
IXLLIST when VTAM attempted to read 
and move a list entry. 


An unexpected return code xxxx and 
reason code yyyy were returned for 
IXLLIST when VTAM attempted to set a 
lock entry. 


An unexpected return code xxxx and 
reason code yyyy were returned for 
IXLLIST when VTAM attempted to release 
a lock entry. 


An unexpected return code xxxx and 
reason code yyyy were returned for 
IXLLIST when VTAM attempted to release 
a lock entry for a failed connector. 
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Table 39 (Page 3 of 3). FFST Probes for Coupling Facility Services (ISTFSCxx) 


Probe Name 


ISTFSC21 


ISTFSC22 


ISTFSC23 


ISTFSC24 


ISTFSC25 


ISTFSC26 


Module 


ISTFSLFG 


ISTFSUBF 


ISTFSUDL 


ISTFSUEN 


ISTFSURH 


ISTFSUWT 


Description 


VTAM found a name defined as both a 
generic resource name and a USERVAR. 


A bad pointer to an IXLLIST buffer list was 
detected by this module. 


An unexpected return code xxxx and 
reason code yyyy were returned for 
IXLLIST when VTAM attempted to delete a 
list entry. 


An unexpected return code xxxx and 
reason code yyyy were returned for 
IXLLIST when VTAM attempted to read list 
control information. 


An unexpected return code xxxx and 
reason code yyyy were returned for 
IXLLIST when VTAM attempted to read a 
list entry from the head of a list. 


An unexpected return code xxxx and 
reason code yyyy were returned for 
IXLLIST when VTAM attempted to write a 
list entry to the end of a list. 


Dependent LU Server Probes 


Table 40. FFST Probes for Dependent LU Server (ISTDLCxx) 


Probe Name 


ISTDLCO1 


ISTDLCO02 
ISTDLCO3 


ISTDLCO4 
ISTDLC33 


ISTDLC34 
ISTDLC35 


ISTDLC36 


ISTDLC37 


Module 
ISTDLCRD 


ISTDLCRD 
ISTDLCDP 


ISTDLCDR 


ISTDLCED 


ISTDLCED 
ISTDLCED 


ISTDLCRS 


ISTDLCRS 


Description 


Element representing the dependent LU requester 
could not be found 


Element representing the PU could not be found. 


Element representing the dependent LU requester 
could not be found. 


Element representing the dependent LU requester 
could not be found. 


Element representing the dependent LU requester 
could not be found. 


Element representing the PU could not be found. 


Element representing DLUS-supported LU could not 


be found. 


Element representing the dependent LU requester 
could not be found. 


Not enough storage to build a REQDACTPU response 


to be sent to the dependent LU requester. 


FFST Probes 


Dump Type 
Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Dump Type 
Mini 


Mini 
Mini 


Mini 


Mini 


Mini 
Mini 


Mini 


Mini 
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FFST Probes 


Directory Services Probes 


Table 41 (Page 1 of 7). FFST Probes for Directory Services (ISTDRCxx) 


Probe Name Module Description Dump Type 

ISTDRCOO ISTDRCRT An unrecognized request element was received. Full 

ISTDRCO1 ISTDRCRT An unrecognized interprocess signal was received. Full 

ISTDRCO2 ISTDROBO An unrecognized function code was received. Full 

ISTDRC04 ISTDROFO A build of a found CV8O0 is required but is not present. Full 

ISTDRCOS ISTDROFO A build of a found CVS3C is required but is not present. Full 

ISTDRCO6 ISTDROFO A build of a found CV3C is required but is not present. Full 

ISTDRCO7 iSTDROFO A build of a found CV3D is required but is not present. Full 

ISTDRCO8 ISTDROFO A build of a found CV3E is required but is not present. Full 

ISTDRCO9 ISTDROFO A build of a found CV40 is required but is not present. Full 

ISTDRCOA ISTDROLM A build of a locate GDS variable is required but is not Full 
present. 

ISTDRCOB ISTDROLM A build of a locate GDS variable is required but is not Full 
present. 

ISTDRCOC ISTDROLM A build of a found GDS variable is required but is not Full 
present. 

ISTDRCOD ISTDROLM A build of a register GDS variable is required but is not Full 
present. 

ISTDRCOE ISTDROLM A build of a CDINIT GDS variable is required but is not Full 
present. 

ISTDRCOF ISTDROLM A build of an |OCD GDS variable is required but is not Full 
present. 

ISTDRC10 ISTDRORS A build of a resource name failed because the Full 
requested name was not recognized. 

ISTDRC11 ISTDROOE A build of a CVOE failed because the requested name Full 
was not recognized. 

ISTDRC12 ISTDRO60 A build of a CV60 failed because the requested name Full 
was not recognized. 

ISTDRC13 ISTDROCG The search type that was requested was not recog- Full 
nized. 

ISTDRC14 ISTDROLM A build of a notify GDS variable is required but is not Full 
present. 

ISTDRC15 ISTDRDUE An unknown entry type was received. Full 

ISTDRC16 ISTDRDDD Either an unknown resource or no resource was found Full 
for a resource delete request. 

ISTDRC17 ISTDRDDD The associated network ID information was not found Full 
for a resource delete request. 

ISTDRC 18 ISTDRDDD A release of storage associated with a resource failed Full 
to complete. 

ISTDRC19 ISTDRDDD A release of storage associated with a resource failed Full 
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Table 41 (Page 2 of 7). FFST Probes for Directory Services (ISTDRCxx) 


Probe Name 


ISTDRCT1A 


ISTDRC1B 


ISTDRC1C 


ISTDRC1D 


ISTDRC1E 


ISTDRC1F 


ISTDRC20 
ISTDRC21 
ISTDRC22 


ISTDRC23 


ISTDRC24 
ISTDRC25 


ISTDRC26 
ISTDRC27 
ISTDRC28 


ISTDRC29 


ISTDRC2A 


ISTDRC2B 


ISTDRC2C 


ISTDRC2D 
ISTDRC2E 
ISTDRC2F 


ISTDRC30 


ISTDRC31 


ISTDRC32 
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Module 
ISTDRDDD 


ISTDRDUD 


ISTDRDCD 


ISTDRDCD 


ISTDRDCD 


ISTDRAPC 


ISTDRAUA 
ISTDRAUA 
ISTDRAVA 


ISTDRAUA 


ISTDREDS 
ISTDRFCH 


ISTDRFLE 
ISTDRFNV 
ISTDRFSI 


ISTDRF35 


ISTDRFLE 


ISTDRFNV 


ISTDRFSI 


ISTDRFPQ 
ISTDRFPY 
ISTDROLO 


ISTDROLO 


ISTDROLO 


ISTDROLO 


Description 


A release of storage associated with a resource failed 
to complete. 


An update directory request was received, but no list 
elements were found. “2 


A release of storage associated with a resource failed 
to complete. 


A release of storage associated with a CACHE_DATA 
interprocess signal failed to complete. 


A CACHE_DATA interprocess signal failed because 
the requested name was not recognized. 


A CP_STATUS interprocess signal failed because the 
requested name was not recognized. 


Cannot remove an adjacent control point from the list. 
Cannot add an adjacent control point to the list. 


ISTDRAUA received an action code indicating that an 
unexpected condition has occurred. 


ISTDRAUA was unable to process an unrecognized 
action code. 


An unexpected interprocess signal was received. 


An unrecognized interprocess signal was received for 
a node role. 


The sender of a request cannot be identified. 
An unknown verify indicator value was received. 


An unrecognized CV35 vector was received from a 
VTAM component. 


VTAM detected a software error while processing a 
CV35 vector. 


A protocol error was detected while processing an 
interprocess signal from a VTAM component. 


An unrecognized name was received from a VTAM 
component. 


A CV35 vector was received while the keep indicator 
was set. | 


An unrecognized network-qualified name was received. 


An unrecognized network-qualified name was received. 


A build of a Locate CV80 is required, but none is 
present. 


A build of a Locate CV60 is required, but none is 
present. 


A build of a Locate CV81 is required, but none is 
present. 


A build of a Locate CV2B is required, but none is 
present. 


FFST Probes 


Dump Type 
Full 


Full 


Full 


Full 


Full 


Full 


Full 
Full 
Full 


Full 


Full 
Full 


Full 
Full 
Full 


Full 


Full 


Full 


Full 


Full 
Full 
Full 


Full 


Full 


Full 
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Table 41 (Page 3 of 7). FFST Probes for Directory Services (ISTDRCxx) 


Probe Name Module _— Description Dump Type 
ISTDRC33 ISTDROLO A build of a Locate CVOE is required, but none is Full 
present. 
ISTDRC34 ISTDROLO A build of a Locate CV35 is required, but none is Full 
present. 
ISTDRC35 ISTDROFI A build of a Find CV80 is required, but none is Full 
present. | 
ISTDRC36 ISTDROFI A build of a Find CV3C is required, but none is Full 
present. | 
ISTDRC37 ISTDROFI A build of a Find CV3C is required, but none is Full 
present. 
ISTDRC38 ISTDROFI A build of a Find CV3D is required, but none is Full 
present. 
ISTDRC39 ISTDROFI A build of a Find CVS3E is required, but none is Full 
present. 
ISTDRC3A ISTDROFI A build of a Find CV81 is required, but none is Full 
present. 
ISTDRC3B ISTDROFI A build of a Find CV81 is required, but none is Full 
present. | 
ISTDRC3C ISTDROFI A build of a Find CV82 is required, but none is Full 
present. 
ISTDRC3D ISTDRMCH An unrecognized input was detected. Full 
ISTDRC3E ISTDRMCS An unrecognized interprocess signal was received. Full 
ISTDRC3F ISTDRMCS An unrecognized state was detected. Full 
ISTDRC40 ISTDRMDO An unrecognized action was requested. Full 
ISTDRC41 — ISTDRMDO An unexpected interprocess signal was received. Full 
ISTDRC42 ISTDRMDO Unexpected elements were found in a locate search. Full 
ISTDRC43 ISTDRMDO An unexpected interprocess signal was received. Full 
ISTDRC44 ISTDRMDO An unrecognized state was detected. Full 
ISTDRC45 ISTDRMDO An unexpected return code was received. Full 
ISTDRC46 ISTDRMDO A list requiring at least one element was empty. Full 
ISTDRC47 ISTDRMFN An unexpected interprocess signal was received. Full 
ISTDRC48 ISTDRMFN An unrecognized state was detected. Full 
ISTDRC49 ISTDRMNV An unexpected return code was received. Full 
ISTDRC4A ISTDRMNV An unexpected return code was received. Full 
ISTDRC4B ISTDRMNV An unexpected interprocess signal was received. Full 
ISTDRC4C ISTDRMSA An unexpected interprocess signal was received. Full 
ISTDRC4D ISTDRMSA An unrecognized state was detected. Full 
ISTDRC4E ISTDRMTD An unexpected interprocess signal was received. Full 
ISTDRC4F ISTDRMTD An unrecognized state was detected. Full 
ISTDRC50 ISTDRRSD Unrecognized inputs for state were detected. Full 
ISTDRC51 Full 


ISTDRRSR 
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Table 41 (Page 4 of 7). FFST Probes for Directory Services (ISTDRCxx) 


FFST Probes 


Probe Name Module Description Dump Type 
ISTDRC52 ISTDRRTP A work-element was received when none was Full 
expected. 
ISTDRC53 ISTDRSBR ISTDRSBR was unable to add a locate control block to Full 
the list. 
ISTDRC54 ISTORSNB An unrecognized state was detected. Full 
ISTDRC55 ISTDRSCH An unexpected interprocess signal was received. Full 
ISTDRC56 ISTDRSDB An unexpected interprocess signal was received. Full 
ISTDRC57 ISTDRSDB An unrecognized state was detected. Full 
ISTDRC58 ISTDRSDS An unexpected return code was received. Full 
ISTDRC59 ISTDRSDS An unexpected return code was received. Full 
ISTDRC5A ISTDRSDS An unexpected return code was received. Full 
ISTDRC5B ISTDRSDS An unexpected return code was received. Full 
ISTDRC5C ISTDRSDS An unexpected return code was received. Full 
ISTDRC5D ISTDRSDS An unexpected interprocess signal was received. Full 
ISTDRC5E ISTDRSDS An unrecognized state was detected. Full 
ISTDRC5F ISTDRSFP An unrecognized combination of node roles was Full 
| detected. 
ISTDRC60 ISTDRSIC An unrecognized state was received. Full 
ISTDRC61 ISTDRSIC An unrecognized status was received. Full 
ISTDRC62 ISTDRSIN An unrecognized search status for a called task was Full 
received. 
ISTDRC63 ISTDRSMD An unrecognized function parameter was received. Full 
ISTDRC64 ISTDRSNV An unrecognized function was specified. Full 
ISTDRC65 ISTDRSNV An unexpected interprocess signal was received. Full 
ISTDRC66 ISTDRSOH An unrecognized function code was received. Full 
ISTDRC67 ISTDRSOH An unrecognized combination of inputs was received. Full 
ISTDRC68 ISTDRSOH An unrecognized combination of inputs was received. Full 
ISTDRC69 ISTDRSOH An unexpected interprocess signal was received. Full 
ISTDRC6A ISTDRSOH An unrecognized state was detected. Full 
ISTDRC6B ISTDRSQS An unrecognized function was detected. Full 
ISTDRC6C ISTDRSSQ An unrecognized search task was requested. Full 
ISTDRC6D ISTDRSYB VTAM was unable to remove a locate control block Full 
from the list. 
ISTDRC6E ISTDRYCD An unrecognized query function was detected. Full 
ISTDRC6F ISTDRSCA An unrecognized entry type was specified. Full 
ISTDRC70 ISTDRDDD A release of storage associated with a resource failed Full 
to complete. : 
ISTDRC71 ISTDROLO A build of a Locate CV82 is required, but none is Full 
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Table 41 (Page 5 of 7). FFST Probes for Directory Services (ISTDRCxx) 


Probe Name 


ISTDRC72 
ISTDRC73 
ISTDRC74 


ISTDRC75 
ISTDRC76 
ISTDRC77 
ISTDRC78 
ISTDRC79 
ISTDRC7A 
ISTDRC7B 
ISTDRC7C 


ISTDRC7D 
ISTDRC7E 
ISTDRC7F 
ISTDRC8&O 
ISTDRC81 

ISTDRC8&2 
ISTDRC8&3 


ISTDRC84 
ISTDRC85 
ISTDRC86 
ISTDRC87 


ISTDRC8&8 


ISTDRC8&9 
ISTDRC8A 


ISTDRC8B 
ISTDRC8&C 


ISTDRC8&D 


Module 
ISTDROFI 


ISTDRMAC 
ISTDRMAC 


ISTDRMAC 
ISTDRMAC 
ISTDRRCF 
ISTDRRCP 
ISTDRRCR 
ISTDRRNE 
ISTDRRNF 
ISTDRRNF 


ISTDRRNF 
ISTDRRNF 
ISTDRRNF 
ISTDRRNF 
ISTDRRNF 
ISTDRRNF 
ISTDRRNF 


ISTDRRNP 
ISTDRRNP 
ISTDRRNR 
ISTDRRNR 


ISTDRRNR 


ISTDRRNR 
ISTDRRNR 


ISTDRSBC 
ISTDRSNB 


ISTDRSSD 
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Description 


A build of a Find CV40 is required, but none is 
present. 


The input received is not recognized for the current 
state. | 


The input received is not recognized for the current 
state. 


An unrecognized state was received. 


An unexpected return code was received. 


_ An unrecognized state was received. 


A register GDS variable is required, but is not present. 


An unexpected return code was received. 
An unexpected return code was received. 
An unrecognized state was received. 


The input received is not recognized for the current 
state. 


The input received is not recognized for the current 
state. 


The input received is not recognized for the current 
state. 


The input received is not recognized for the current 
state. 


The input received is not recognized for the current 
state. | 


The input received is not recognized for the current 
state. 


The input received is not recognized for the current 
state. 


The input received is not recognized for the current 
state. 


A locate control block is required but is not present. 
An unrecognized state was detected. 
An unexpected return code was received. 


The available length is not sufficient for a required 
GDS variable. 


The available length is not sufficient for a required 
GDS variable. 


An unexpected return code was received. 


The available length is not sufficient for a required 
GDS variable. 


A parsed locate element is required, but is not present. 


An invalid state was detected upon entry to 
ISTDRSNB. 


_ An unknown task was loaded. 
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Dump Type 
Full 


Full 


Full 


Full 
Full 
Full 
Full 
Full 
Full 
Full 
Full 


Full 


Full 


Full 


Full 


Full 
Full 
Full 


Full 
Full 
Full 
Full 


Full 


Full 
Full 


Full 
Full 


Full 
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Table 41 (Page 6 of 7). FFST Probes for Directory Services (ISTDRCxx) 


Probe Name 


ISTDRC8E 


ISTDRC8F 
ISTDRC90 
ISTDRC91 
ISTDRC92 


ISTDRC93 


ISTDRC94 
ISTDRC95 
ISTDRC96 
ISTDRC97 
ISTDRC98 
ISTDRC99 
ISTDRC9A 
ISTDRCA7 
ISTDRCA8 
ISTDRCA9 
ISTDRCAA 
ISTDRCAB 
ISTDRCAC 
ISTDRCAD 
ISTDRCAE 
ISTDRCAF 


ISTDRCBO 
ISTDRCB1 
ISTDRCB2 
ISTDRCB3 


ISTDRCB4 
ISTDRCBS5 
ISTDRCB6 
ISTDRCB7 
ISTDRCB8 
ISTDRCB9 
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Module 
ISTDRFDS 


ISTDRFDS 
ISTDRSHR 
ISTDRSHR 
ISTDRSHR 


ISTDRSHR 


ISTDRSNI 
ISTDRSNI 
ISTDRDUP 
ISTDRDQP 
ISTDRDDP 
ISTDRERT 
ISTDROCG 
ISTDRMBO 
ISTDRMBO 
ISTDRMBO 
ISTDRMBO 
ISTDREBN 
ISTDRMBN 
ISTDRMGS 
ISTDRMGS 
ISTDRFGS 


ISTDRFGS 


ISTDRFGU 


ISTDROIE 


ISTDROIE 


ISTDRFMH 
ISTDRFBN 
ISTDRFBN 
ISTDRFBN 
ISTDRFBN 
ISTDRSPC 


Description 


A directory server notify was received with an empty 
list. 


An unexpected return code was received. 
An unexpected input operation was received. 
An unrecognized max hierarchy was detected. 


An unexpected resource CV combination was 
detected. 


An unexpected max hierarchy combination was 
detected. 


An unrecognized locate was detected. 


An unrecognized node role was identified in an LCB. 


A DBUPDATE was attempted at a VTAM end node. 
A DBQUERY was attempted at a VTAM end node. 
A DBDELETE was attempted at a VTAM end node. 
The DS PAB router received an unrecognized IPS. 
Unrecognized parameter value was received. 

An unrecognized interprocess signal was received. 
An unrecognized interprocess signal was received. 
An unrecognized interprocess signal was received. 
An unrecognized state was detected. 

An unrecognized state was detected. 

An unrecognized state was detected. 

An unrecognized interprocess signal was received. 
An unrecognized state was detected. 


An unrecognized control vector was detected; CVOE 
was expected but is not present. 


An unrecognized control vector was detected; CV35 
was expected but is not present. 


An unrecognized control vector was detected; CV35 
was expected but is not present. 


A build of a CVOE failed due to an unrecognized 
name. 


A build of a Find CVOE is required, but none is 
present. | 


Incorrect hierarchy was passed to module. 


A unrecognized network-qualified name was detected. 


List operation failed. 


A unrecognized network-qualified name was detected. 


An attempt to free storage failed. 


List operation failed. 
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Dump Type 
Full 


Full 
Full 
Full 
Full 


Full 


Full 
Full 
Full 
Full 
Full 
Full 
Full 
Full 
Full 
Full 
Full 
Full 
Full 
Full 
Full 
Full 


Full 


Full 


Full 


Full 


Full 
Full 
Full 
Full 
Full 
Full 
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Table 41 (Page 7 of 7). FFST Probes for Directory Services (ISTDRCxx) 


Probe Name Module . Description Dump Type 
ISTDRCBA ISTDRSPC List operation failed. Full 
ISTDRCBB ISTDRSPC List operation failed. Full 
ISTDRCBC ISTDRSPC List operation failed. | Full 
ISTDRCBD ISTDRSPC Attempt to free storage failed. Full 
ISTDRCC1 ISTDRSDT An unrecognized state was detected on entry. Full 
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Table 42 (Page 1 of 2). FFST Probes for IP Network Access (ISTIPCxx) 


Probe Name 


ISTIPCO1 
ISTIPCO2 
ISTIPCO3 


ISTIPCO4 


ISTIPCOS 
ISTIPCO6 
ISTIPCO7 
ISTIPCO8 
ISTIPCO9 


ISTIPC10 
ISTIPC11 


ISTIPC12 


ISTIPC13 
ISTIPC14 


ISTIPC15 


ISTIPC16 


ISTIPC17 
ISTIPC18 
ISTIPC19 
ISTIPC20 


ISTIPC21 


ISTIPC22 
ISTIPC23 
ISTIPC24 
ISTIPC25 
ISTIPC26 


Module 
ISTIPCDI 
ISTIPCDN 
ISTIPCDR 


ISTIPCDR 


ISTIPCDW 
ISTIPCDW 
ISTIPCIC 
ISTIPCIR 
ISTIPCIS 


ISTIPCOR 
ISTIPCRB 


ISTIPCRB 


ISTIPCRB 
ISTIPCRB 


ISTIPCRB 


ISTIPCRC 


ISTIPCSE 
ISTIPCSG 
ISTIPCSG 
ISTIPCSG 


ISTIPCWB 


ISTIPCWB 
ISTIPCWR 
ISTIPCWR 
ISTIPCWR 
ISTIPCDW 


Description 
Unexpected work element was received. 
Network-qualified name was not valid. 


Error occurred when VTAM was reading data into its 
buffers. 


Error occurred when VTAM was reading data into its 
buffers. 


Unexpected MPTN format was received. 
Unexpected work element was received. 
No outstanding work element was found. 
Unexpected value was found in work element field. 


Unexpected interrupt type was detected. See 
Table 80 on page 1165 to determine what book 
describes I|UCV external interrupts. 


Unexpected work element was received. 


Unexpected finite state machine state was detected 
when VTAM was reading data into its buffers. 


Error occurred when VTAM was reading data into its 
buffers. 


Unexpected MPTN format was received. 


Error occurred when VTAM was reading data into its 
buffers. 


Mismatched transmission subsystem control block 
(TSCB) count was detected when VTAM was reading 
data into its buffers. 


Unexpected finite state machine state was detected 
when VTAM was reading data into its buffers. 


Internal control block was not found. 
Unexpected work element. 
Unexpected value was found in work element field. | 


Unexpected finite state machine state was detected 
when VTAM was reading data into its buffers. 


Unexpected finite state machine state was detected 
when VTAM was reading data into its buffers. 


MPTN format length mismatch was detected. 
Unexpected work element was received. 
Unexpected work element was received. 
Unexpected work element was received. 


Unexpected work element was received. 


FFST Probes 


Dump Type 
Mini 
Mini 
Full 


Full 


Mini 
Mini 
Full 
Mini 
Mini 


Mini 


Mini 
Full 


Mini 
Full 


Full 


Mini 


Mini 
Mini 
Mini 
Mini 


Mini 


Full 
Mini 
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Table 42 (Page 2 of 2). FFST Probes for IP Network Access (ISTIPCxx) _ 


Probe Name 


ISTIPC27 


Module 
ISTIPCDR 


Dump Type 


MPTN datagram length is not valid. The FFST probe Full 
is tripped when a MPTN datagram received from 

TCP/IP requires more than twenty data buffers to 

receive it. A datagram of this size is excessively large 

and indicates a possible TCP/IP error. 


Description 


LU Network Services Probes 


Table 43. FFST Probes for LU Network Services (ISTNSCxx) 


Probe Name 
- ISTNSCO1 


Module 


ISTNSCRS 


Description Dump Type 


A suspended log mode is not found. Full 


Check the mode the application program specifies on 
the APPCCMD CONTROL=OPRCNTRL, 
QUALIFY=RESTORE macroinstruction. 


You can use the following VTAM dump functions to 


display advanced program-to-program communication 
(APPC)-related information: 


e APPLCONV 
e APPLMODE 
e APPMODAL 
e PARTNRLU. 


Management Services Transport Probes 


Table 44 (Page 1 of 2). FFST Probes for Management Services Transport (ISTMTCxx) 


Probe Name 


ISTMTCO1 


ISTMTCO02 


ISTMTCO3 


ISTMTC04 


ISTMTCO5 


ISTMTCO06 


ISTMTC0O7 


ISTMTCO8 


Module 
ISTMTCFF 


ISTMTCFF 


_ISTMTCFF 


ISTMTCFF 


ISTMT CFF 


ISTMTCFF 


ISTMTCFF 


ISTMTCFF 


860  VTAM V4R2 Diagnosis 


Description Dump Type 


The main router received an unrecognized request-unit Mini 
processing element. 


The main router received an unrecognized work Full 
— element. 
The START_TP_REPLY signal that is received con- Mini 


tains a return code that is incorrect or unrecognized for 
this leg. 


An unexpected condition is detected when a query Mini 
request is sent to the NetView application program's 
programmable peripheral interface (PPI) queue. 


An unexpected condition is detected while defining the Mini 
VTAM queue to the NetView application program's pro- 
grammable peripheral interface (PPI). 


An unexpected condition is detected while sending Mini 
data from VTAM to the NetView processor across the 
programmable peripheral interface (PPI). 


The main router received an unrecognized work Mini 
element. 
Unrecognized data is received from the NetView appli- Mini 


cation program across the programmable peripheral 
interface (PPI). 
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Table 44 (Page 2 of 2). FFST Probes for Management Services Transport (ISTMTCxx) 


Probe Name Module Description 

ISTMTCO9 ISTMTCFF Unrecognized data is received from the NetView appli- 
cation program. 

ISTMTC10 ISTMTCFF The PP! queue received from the NetView application 
program contains unrecognized data. 

ISTMTC11 ISTMTCFF VTAM could not create a process scheduling table for 
MI. 

ISTMTC12 ISTMTCFF The MDS-MU received from the NetView application 
program is unrecognized. 

ISTMTC13 ISTMTCFF An expected outstanding request unit is not found on 
the outstanding request unit list. 

ISTMTC14 ISTMTCFF An expected outstanding request unit is not found on 
the outstanding request unit list. 

ISTMTC15 ISTMTCFF An expected session list entry is not found, but an ATL 
entry is found. 

ISTMTC16 _ISTMTCFF An expected session-list entry is not found, but an ATL 


entry is found. 


Network Resource Management Probes 


Table 45. FFST Probes for Network Resource Management (ISTNACxx) 


Probe Name Module Description 
ISTNACO1 ISTNACTT VTAM cannot complete a normal CLOSE ACB and 
must force the CLOSE ACB. 


Session Services Probes 


Table 46. FFST Probes for Session Services (ISTSSCxx) 


Probe Name Module Description 

ISTSSCO1 ISTSSCTM A request/response unit (RU) is rejected by one of the 
session services parsing modules. This probe pro- 
vides information about a condition that will cause 
hung terminals and logon problems. 

ISTSSC02 ISTSSCXM Address conflict was detected during merge. 

ISTSSC03 ISTSSCXV An SRT was missing for an autologon session. As a 
result, session setup failed. 

ISTSSCZ1 ISTSSCYC An attempt was made to dequeue a SIB from a PU's 


SIB queue, but the SIB was not on the queue. 


Session Services CP-CP Probes 


Table 47 (Page 1 of 2). FFST Probes for Session Services CP-CP (ISTSCCxx) 


Probe Name 


ISTSCCO1 


Module 
ISTSCCRT 


Description 


A request processing element is received which con- 
tained an unrecognized request unit processing 
element (RUPE). 


FFST Probes 


Dump Type 
Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Dump Type 
Full 


Dump Type 
Mini 


Mini 
Full 


Full 


Dump Type 
Mini 
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Table 47 (Page 2 of 2). FFST Probes for Session Services CP-CP (ISTSCCxx) 


Probe Name 


ISTSCC02 


ISTSCCO3 


ISTSCC04 


ISTSCCO5 


ISTSCCO6 


ISTSCCO7 


ISTSCCO8 
ISTSCCO9 
ISTSCC10 
ISTSCC11 


ISTSCC15 


ISTSCC16 


ISTSCC17 


ISTSCC19 


ISTSCC20 


ISTSCC21 


ISTSCC23 


Module 
ISTSCRCA 


ISTSCCFM 


ISTSCUAR 
ISTSCUAR 
ISTSCUBS 
ISTSCUBS 
ISTSCUDS 
ISTSCUNO 
ISTSCUNO 
ISTSCUNO 


ISTSCCFM 


ISTSCTRQ 


ISTSCRAY 


ISTSCTRC 


ISTSCCFM 


ISTSCCRT 


ISTSCCRT 


862  VTAM V4R2 Diagnosis 


Description 


SSC attempted to add an adjacent node control block 
to the adjacent node contro! block list, but the add 
failed to complete normally. 


The SSC coordinator finite state machine processor 
received null input in an unexpected state when one or 
more of the CP-CP sessions is in active or pending 
active status. 


An internal SSC module passed an unrecognized 
session status to ISTSCUAR. 


An internal SSC module passed an unrecognized 
session type to ISTSCUAR. 


An internal SSC module passed an unrecognized 
session type to ISTSCUBS. 


An internal SSC module passed an unrecognized 
session status to ISTSCUBS. 


An internal SSC module passed an unrecognized 
session type to ISTSCUDS. 


SSC entered an unexpected state on a contention- 
winner session. 


SSC entered an unexpected state on a contention- 
loser session. 


An internal SSC module passed an unrecognized 
session type to ISTSCUNO. 


The SSC coordinator finite state machine processor 
received non-null input in an unexpected state when 
one or more of the CP-CP sessions is in active or 
pending active status. 


The REQUEST_CP_CAPABILITIES_TP received as 
input a signal that is neither an 
ACT_CP_CP_SESSION request nor a 


~CONTINUE_CW response. 


An adjacent node has changed either from network | 
node to end node or from end node to network node. 


The SEND_REJECT_CONVGRP_TP received an input 
signal other than a DEACTIVATE_CP_CP_SESSION 
request. 3 


The SSC coordinator finite state machine processor 
encountered a should-not-occur condition and no 
CP-CP session cleanup is required. 


An adjacent node control block is not found for the 
received signal. 


A processing element is queued to session services 
CP-CP (SSC) but is not recognized to be either a 
request unit processing element (RUPE) or a timer 
queue element. 
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Dump Type 
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Session Services LU-LU Probes 


FFST Probes 


The following table contains the LU-LU session services (SSL) software probes. When an SSL software 
probe is triggered, an error has occurred while processing network session services for an LU-LU con- 
nection. The search, session initiation, or request causing the error is rejected. VTAM will attempt to 
recover from the error and continue processing subsequent requests. Recovery might not be possible for 
some types of errors and subsequent requests might fail, terminals might hang, and other types of errors 


might occur. 


A system dump is taken to assist in identifying the source of the problem. A VABEND macroinstruction 
can also be processed if specified by the probe instruction. The processing element is freed and proc- 


essing continues. 


Table 48 (Page 1 of 7). FFST Probes for Session Services LU-LU (ISTSLCxx) 


Probe Name 


ISTSLCO1 


ISTSLCO2 


ISTSLCO3 


ISTSLC04 


ISTSLCO5 


ISTSLCO6 


ISTSLCO7 


ISTSLCO8 


ISTSLCO9 


ISTSLC10 


ISTSLC11 


ISTSLCO12 


ISTSLCO13 
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Module 
ISTSLCRT 


ISTSLRDP 


ISTSLRDP 


ISTSLRDP 


ISTSLRDP 


ISTSLRDP 


ISTSLRXS 


ISTSLTPI 


ISTSLBXN 


ISTSLURR 


ISTSLBXJ 


ISTSLRXJ 


ISTSLRXJ 


Description 


An unknown interprocess signal was dispatched to the 
SSL component process anchor block (PAB). 


Finite state machine information is missing when a 
SEARCH_RPY signal is processed. 


Finite state machine information is missing when a 
CDINIT SEARCH_RPY signal is processed. 


Finite state machine information is missing when an 
lOCD SEARCH_RFPY signal is processed. 


Finite state machine information is missing when a 
NOTIFY SEARCH_RPY signal is processed. 


Finite state machine information is missing when a 
SEARCH_RPY signal is processed and a storage 
failure occurs. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


An unexpected combination of conditions was encount- 
ered during third-party initiated finite state machine 
processing. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. | 


Route Selection control vector (RSCV) information is 
missing from SSL's session initiation control block 
when performing a build request for a 
RECOMPUTE_ROUTE signal. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


Finite state machine information is missing when an 
INIT_.OTHER_COMP signal is processed, and a 
storage failure occurred. 


Finite state machine information is missing when an | 
INIT_OTHER_COMP signal is processed. 


Dump Type 


| Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 
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Table 48 (Page 2 of 7). FFST Probes for Session Services LU-LU (ISTSLCxx) 


Probe Name 


ISTSLC14 
ISTSLC15 


ISTSLC16 


ISTSLC17 


ISTSLC18 
ISTSLC19 
ISTSLC20 
ISTSLC21 


ISTSLC22 


ISTSLC23 
ISTSLC24 
ISTSLC25 
ISTSLC26 


ISTSLC27 
ISTSLC28 
ISTSLC29 


ISTSLC30 


ISTSLC31 


Module 
ISTSLBXI 


ISTSLUDS 


ISTSLUDS 


ISTSLUGT 


ISTSLUBX 
ISTSLUBX 
ISTSLUBX 
ISTSLUBX 


ISTSLRXI 


ISTSLVPE 
ISTSLUSC 
ISTSLURX 
ISTSLURD 


ISTSLSNO 
ISTSLSNO 
ISTSLSNO 


ISTSLSNO 


ISTSLUBD 


864  VTAM V4R2 Diagnosis 


Description 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


An error occurred while the SSL component was 
removing a session initiation control block key from the 
list. 


An error occurred while the SSL component was 
removing a session initiation control block from the list. 


The ACMDT's node type information for this node had 
an unknown value because it did not indicate whether 
this is a VTAM end node or a VTAM network node. 


A build request was received for an unrecognized 
interprocess signal. 


A build request was received for an unrecognized 
interprocess signal. 


The SSL component could not remove a fully qualified 
procedure correlation identifier (FQPCID) from the list. 


The SSL component could not remove a 
FQPCID_MODIFIER from the list. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


An unrecognized signal was received from directory 
services. 


The SSL component was unable to determine the type 
of signal to send to session services. 


An unrecognized interprocess signal was received 


. from session services. 


An unrecognized interprocess signal was received 
from directory services. 


The Route Selection control vector (RSCV) information 
is missing from the control vector list of the session ini- 
tiation control block. 


The Route Selection control vector (RSCV) information 
is missing from the control vector list of the session ini- 
tiation control block. 


An unrecognized session initiation status was received 
for the current system state. 


An unexpected combination of conditions was encount- 
ered during finite state machine processing initiated by 
the secondary logical unit (SLU) at a network node 
(NN). 


A build request was received for an unrecognized 
interprocess signal. 
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Table 48 (Page 3 of 7). FFST Probes for Session Services LU-LU (ISTSLCxx) 
Probe Name Module 
ISTSLC32 ISTSLSED 


Description Dump Type 


An unexpected combination of conditions was encount- Mini 
ered during finite state machine processing initiated by 
the secondary logical unit (SLU) at an end node (EN) 


ISTSLC33 


ISTSLCO34 


ISTSLC35 


ISTSLC36 


ISTSLC37 


ISTSLC38 


ISTSLC39 


ISTSLC40 


ISTSLC41 


ISTSLC42 


ISTSLC43 


ISTSLC44 


ISTSLC45 


ISTSLC46 


ISTSLC47 


ISTSLC48 


ISTSLC49 
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ISTSLRXO 


ISTSLRXQ 


ISTSLRXC 


ISTSLRXC 


ISTSLBXV 


ISTSLBXS 


ISTSLRXD 


ISTSLPND 


ISTSLRXV 


ISTSLPNO 


ISTSLPNO 


ISTSLPNO 


ISTSLPNO 


ISTSLBXQ 


ISTSLBXC 


ISTSLRTT 


ISTSLRTR 


destination logical unit (DLU). 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


Finite state machine information is missing when a 
QUEUED signal is processed. 


Finite state machine information is missing when a 
SESS_REQ_COMP signal is processed. 


Finite state machine information is missing when a 
SESS_REQ_COMP signal is processed and storage 
problems occur. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


Finite state machine information is missing when a 
DEQUEUE signal is processed. 


An unexpected combination of conditions was encount- 
ered during finite state machine processing initiated by 


the primary logical unit (PLU) at a network node. 


Finite state machine information is missing when a 
PROV_SC signal is processed. 


' The Route Selection control vector (RSCV) information 
is missing from the control vector list of the session ini- 


tiation control block. 


The RSCV information is missing from the control 
vector list of the session initiation control block. 


An unexpected combination of conditions was encount- 
ered during finite state machine processing initiated by 


the primary logical unit (PLU) at a network node. 


The RSCV information is missing from the control 
vector list of the session initiation control block. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


Finite state machine information is missing when a 
RECOMPUTE_ROUTE_RPY signal is processed. 


Finite state machine information is missing when a 
REQ _ROUTE_RFPY signal is processed. 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 


Mini 
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Table 48 (Page 4 of 7). FFST Probes for Session Services LU-LU (ISTSLCxx) 


Probe Name 


ISTSLC50 


ISTSLC51 


ISTSLC52 


ISTSLC53 


ISTSLC54 


ISTSLC55 


ISTSLC56 


ISTSLC57 


ISTSLC58 


ISTSLC59 


ISTSLC60 


ISTSLC61 


ISTSLC62 


ISTSLC63 


ISTSLC64 


ISTSLC65 


ISTSLC66 


Module 
ISTSLRDR 


ISTSLRTC 


ISTSLRTC 


ISTSLRTV 


ISTSLRNT 


ISTSLRNT 


ISTSLRNT 


ISTSLRDN 


ISTSLRDC 


ISTSLPXR 


ISTSLPXT 


ISTSLPYR 


ISTSLPNS 


ISTSLPNS 


ISTSLPED 


ISTSLPEO 


ISTSLBXT 


866 VTAM V4p2 Diagnosis 


Description 


Finite state machine information is missing when a 
SEARCH_REQ signal is processed. 


Class of service (COS) and transmission priority field 
(TPF) control vector information is missing from the 
control vector list of the session initiation control block. 


Finite state machine information is missing when a 
REQ_COS_TPF_RPY signal is processed. 


Finite state machine information is missing when a 
REQ_TG_VECTORS_FPY signal is processed. 


The NOTIFY generalized data stream (GDS) variable 
being processed contained a NOTIFY_TYPE that was 
unknown or not valid. 


Notify control vector 80 (CV80) information is missing 
from the control vector list of the session initiation 
control block. 


‘Notify CV81 information is missing from the control 


vector list of the session initiation control block. 


The CDINIT GDS variable information is missing from 
a NON_VERIFY_REQ signal received from directory 
services. 


Finite state machine information is missing when a 
CHAIN_FLOW signal is processed. 


An unexpected combination of conditions was encount- 
ered during processing of the PLU-initiate exit border 
node pre-processor finite state machine (FSM). 


An unexpected combination of conditions was encount- 
ered during processing of the PLU-initiate exit border 
node post-processor finite state machine. 


An unexpected combination of conditions was encount- 
ered during processing of the PLU-initiate entry border 
node pre-processor finite state machine. 


RSCV information is missing from the control vector 
list of the session initiation control block. 


An unexpected combination of conditions was encount- 
ered during finite state machine processing initiated by 
the primary logical unit (PLU) at a network node. 


An unexpected combination of conditions was encount- 
ered during finite state machine processing initiated by 
the primary logical unit (PLU) at an end node destina- 
tion logical unit. 


An unexpected combination of conditions was encount- 
ered during finite state machine processing initiated by 
the primary logical unit (PLU) at an end node origi- 
nation logical unit. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 
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Table 48 (Page 5 of 7). FFST Probes for Session Services LU-LU (ISTSLCxx) 


Probe Name 


ISTSLC67 


ISTSLC68 


ISTSLC69 


ISTSLC70 


ISTSLC71 


ISTSLC72 


ISTSLC73 


ISTSLC74 


ISTSLCO75 


ISTSLC76 


ISTSLC77 


ISTSLC78 


ISTSLC79 


ISTSLC8&0O 


ISTSLC81 


ISTSLC82 


Module 
ISTSLBXR 


ISTSLBXP 


ISTSLBXO 


ISTSLBXE 


ISTSLBXD 


ISTSLBDL 


ISTSLSND 


ISTSLSND 


ISTSLSEO 


ISTSLUCS 


ISTSLRXN 


ISTSLUSL 


ISTSLCRT 


ISTSLR63 


ISTSLBLC 


ISTSLBLC 


Description 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


A failure occurred while performing post-processor 
information processing for a signal being sent to 
session services. 


An unrecognized session initiation status was received 
for the current system state in SLU-initiate finite state 
machine processing. 


An unexpected combination of conditions occurred 
during SLU-initiate finite state machine processing at a 
network node. 


An unexpected combination of conditions occurred 
during SLU-initiate finite state machine processing at 
an end node origination logical unit. 


The SSL component was unable to remove the key 
entry for the session initiation control block from the 
list. 


Finite state machine information is missing when a 
PEND_SC signal is processed. 


An unrecognized LU role was provided for a session 


initiation control block find request. 


An unrecognized work element was dispatched to the 
SSL process anchor block (PAB). 


The SSL component was unable to remove a CV63 
from the control vector list of the session initiation 
control block. 


A CV82 control vector contains a network-qualified | 
sender name that is not valid. 


A CV82 control vector contains a network-qualified 
host receiver name that is not valid. 
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Table 48 (Page 6 of 7). FFST Probes for Session Services LU-LU (ISTSLCxx) 


Probe Name 


ISTSLC84 


ISTSLC85 


ISTSLC8&6 


ISTSLC87 


ISTSLC8&8 


ISTSLC89 
ISTSLC90 


ISTSLC91 


ISTSLC92 


ISTSLC93 


ISTSLC94 


ISTSLC95 


ISTSLC96 


ISTSLC97 


ISTSLC98 


ISTSLC99 


Module 
ISTSLUNV 


ISTSLRDI 


ISTSLBXB 


ISTSLBXH 


ISTSLBTM 


ISTSLRXB 
ISTSLRXB 


ISTSLRTM 


ISTSLUBX 


ISTSLRXB 


ISTSLPYT 


ISTSLSXR 


ISTSLSXT 


ISTSLSYR 


ISTSLSYT 


ISTSLUBR 


868  VTAM V4R2 Diagnosis 


Description 


The original class of service (COS) associated with the 
SLU-initiate request was not found in the parent 
session initiation control block during a non-verify 
search sent in response to a SLU-initiate request. 


The SSL component received a 
SESS_INIT_INFO_REQ signal which contained incon- 
sistent data. 


Failure occurred when performing front-end processing 
fora BN_SESS_RPY signal being sent to session ser- 
vices. 


Failure occurred when performing front-end processing 
for a CACHE_BN_INFO signal being sent to session 
services. 


The network-qualified adjacent non-native CP name is 
not valid. 


The network-qualified adjacent LU name is not valid. 


Failure occurred when performing front-end processing 
fora BN_SESS_RPY signal being sent to session ser- 
vices. 


Finite state machine information was missing when a 
PROCESS_MAP_COS signal from topology routing 
services (TRS) was being processed. 


The RSCV that should have been in the session initi- 
ation control block when building a CACHE_BN_INFO 
to session services was missing. 


The class of service (COS) was received on a 
BN_SESS_REQ, but the primary logical unit (PLU) 
COS from LOCATE time processing could not be 
found. 


An unexpected combination of conditions was encount- 
ered during processing of the PLU-initiate entry border 
node post-processor finite state machine. 


An unexpected combination of conditions was encount- 
ered during processing of the SLU-initiate exit border 
node pre-processor finite state machine. 


An unexpected combination of conditions was encount- 
ered during processing of the SLU-initiate exit border 
node post-processor finite state machine. 


An unexpected combination of conditions was encount- 
ered during processing of the SLU-initiate entry border 
node pre-processor finite state machine. 


An unexpected combination of conditions was encount- 
ered during processing of the SLU-initiate entry border 
node post-processor finite state machine. 


An unexpected combination of conditions was encount- 
ered during border node request finite state machine 
processing. 
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Table 48 (Page 7 of 7). FFST Probes for Session Services LU-LU (ISTSLCxx) 


Probe Name 


ISTSLCAO 


ISTSLCAT 


ISTSLCA2 


ISTSLCA3 
ISTSLCA4 


ISTSLCA5 


Module 
ISTSLUFR 


ISTSLSNO 


ISTSLUAS 


ISTSLR2B 
ISTSLRDI 


ISTSLRDP 


Description 


The finite state machine router was called for a situ- 
ation where a FSM is not used. 


Route Selection Control Vector (RSCV) missing from 
the session initiation control block's control vector list. 


An unexpected combination of conditions was encount- 
ered during dependent LU requester search finite state 
machine processing. 


Missing subvector on CV2B (RSCV). 


The DLU is non-native, but the previously stored DLU 
information and the DLU information on the 
SESS_INIT_INFO_REQ IPS just received do not 
match. 


The DLU is non-native, but the previously stored DLU 
information and the DLU information on the 
SEARCH_RFPY IPS just received do not match. 


Storage Management Probes 


Table 49. FFST Probes for Storage Management (ISTORCxx) 


Probe Name 


ISTORCO1 


Module 


ISTORCHB 


Description 


Unexpected I/O condition was detected. The output 
contains the buffer pool control block (BPCB) and one 
page of storage from each buffer pool expansion block 
(PXB). 


Topology and Routing Services Probes 


Table 50 (Page 1 of 2). FFST Probes for Topology and Routing Services (ISTTRCxx) 


Probe Name 


ISTTRCO1 
ISTTRCO2 
ISTTRCO3 


ISTTRCO4 


ISTTRCOS 


ISTTRCO6 


ISTTRCO7 


ISTTRCO8 


Module 

ISTTRCRT 
ISTTRCRT 
ISTTRQDN 


ISTTRIFP 


ISTTRINP 


ISTTRPSH 


ISTTRQDT 


ISTTRTLT 


Description 
An unknown work element is received. 
An unknown signal is contained with the work element. 


Issued when attempting to clean up storage for a node 
information block that is not found. 


While processing a topology database update (TDU), 
an unrecognized finite state machine state is encount- 
ered. 


An internal parsing error has occurred. An Input_TDU 
is encountered with a mismatch between the number 
of node vectors and the number of associated trans- 
mission group (TG) vectors. 


An unrecognized transmission group (TG) type is 
received on a RQ_SINGLE_HOP_ROUTE signal. 


Unable to delete a node from a tree because the node 
cannot be found on the tree. 


An unrecognized partner node type is received on a 
TG_UPDATE signal. 


FFST Probes 


Dump Type 
Mini 


Mini 
Full 


Full 
Mini 


Mini 


Dump Type 
Mini 


Dump Type 
Mini 
Mini 
Full 


Mini 


Mini 


Mini 


Full 


Mini 
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Table 50 (Page 2 of 2). FFST Probes for Topology and Routing Services (ISTTRCxx) 


Probe Name Module Description Dump Type 

ISTTRCO9 ISTTRTLT The transmission group (TG) direction specified on a Mini 
TG_UPDATE signal is not recognized. 

ISTTRC10 ISTTRRPP A problem is encountered while attempting to uncache Full 
the session trees from the topology and routing ser- 
vices (TRS) database. 

ISTTRC11 ISTTRRPP While scanning the topology and routing services Mini 
(TRS) database an unidentified resource is found. 

ISTTRC12 ISTTRDGM An unrecognized secondary LU (SLU) node identifica- Mini 
tion is received on a REQ_MULTIPLE_ROUTES 
signal. 

ISTTRC13 ISTTRRRR A route to a gateway node is received on a Mini 


REQUEST_ROUTE; however, the signal contained 
unrecognized information. | 


Trace Services Probes 


Table 51. FFST Probes for Trace Services (ISTRACxx) 


Probe Name Module Description Dump Type 
ISTRACOT1 ISTRACZT FFST dump from the VTAM trap module. Full 
ISTRAC02 ISTRACZT FFST dump from the VTAM trap module consisting of Mini 


the ATCVT and the VTAM internal trace (VIT). 


ISTRACZ3 ISTITCAS FFST full dump for a predetermined APPC sense code Full 
ISTRACZ4 ISTITCAS FFST full dump for a predetermined RPL6 return code Full 


Transmission Subsystem Probes 


Table 52 (Page 1 of 2). FFST Probes for Transmission Subsystem (ISTTSCxx) 


Probe Name Module Description Dump Type 
ISTTSCO1 ISTTSCRI Inbound path information unit (PIU) with an out-of- Mini 
order sequence number was detected. The output 
includes the transmission subsystem control block 
(TSCB) containing the PIU with the unexpected 
sequence number and the virtual route control block 
(VRBLK) containing the expected sequence number. 
ISTTSCO2 ISTTSC8S Unrecognized multipath channel sweep work element Mini 
was detected. 
ISTTSCO3 ISTTSC8E Unexpected multipath channel sweep finite state Mini 
machine state was detected. 
ISTTSCO4 ISTTSC8I Zero active read subchannel count was detected. Mini 
ISTTSCO5 ISTTSC8E Zero active write subchannel count was detected. Mini 
ISTTSCO6 ISTTSC8E Zero read sweep count decremented. Mini 
ISTTSCO7 ISTTSC8E Zero write sweep count decremented. Mini 
ISTTSCO8 ISTTSCOL Unexpected input in current state was received. Mini 
ISTTSCO9 ISTTSC9C Unexpected input in current state was received. Mini 
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Table 52 (Page 2 of 2). FFST Probes for Transmission Subsystem (ISTTSCxx) 


Probe Name 


ISTTSC10 


ISTTSC11 
ISTTSC12 
ISTTSC13 
ISTTSC14 
ISTTSC15 


ISTTSC16 


ISTTSC17 


ISTTSC18 


ISTTSC19 


ISTTSC20 


ISTTSC21 
ISTTSC22 
ISTTSC23 
ISTTSC24 


ISTTSC25 
ISTTSC26 
ISTTSC27 
ISTTSC28 
ISTTSC29 
ISTTSC30 


Module 
ISTTSC8E 


ISTTSC8D 
ISTTSC8E 
ISTTSC8E 
ISTTSC8E 
ISTTSCM8 


ISTTSCM8 


ISTTSC8X 


ISTTSC8X 


ISTTSC8B 


ISTTSC87 


ISTTSCOX 
ISTTSCOP 
ISTTSC9D 
ISTTSCS8I 


ISTTSC8l 
ISTTSC8I 
ISTTSC8I 
ISTTSCM8 
ISTTSC8X 
ISTTSC6F 


Description 


Multipath channel incorrect path information unit (PIU) 
was built. 


Unexpected input was received. | 
Multipath channel group lost the last read device. 
An attempt to send a data element response failed. 
Multipath channel device busy was detected. 


Multipath channel PU services process anchor block 
(PUPAB) finite state machine error was detected. 


Unable to obtain storage for a request unit processing 
element (RUPE). 


Multipath channel PUPAB finite state machine error 
was detected. 


Unable to obtain storage for a request unit processing 
element (RUPE). 


Empty node control block (NCB) pending queue was 
detected. 


Unexpected value for request/response unit (RU) was 
received. 


Unexpected input in current state was received. 
Unexpected input was received. 
Unexpected input was received. 


Unexpected multipath channel sweep finite state 
machine state was detected. 


Zero active write subchannel count was detected. 
Zero read sweep count decremented. 

Zero write sweep count decremented. 
Unexpected input was received. 

Unexpected input was received. 


ISTTSC6F fails to dequeue the TRGCB from 
ATCNCBQ during deactivation of a major node. This 
can result in an abend in ISTTSCWU. 


FFST Probes 


Dump Type 
Mini 


Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
Mini 
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Appendix D. Channel Programs 


This appendix describes the normal sequence of I/O channel control words (CCWs) 
within channel programs for the communication controller and channel-attached 
devices. If you determine that the problem is in an I/O sequence, you need to 
know the normal sequence of I/O CCWs within these channel programs. With a 
dump, the VIT trace with the ClO option, or a CCWTRACE (if available), you can 
compare the sequence that happened with the expected sequence. When there is 
a deviation, you can then look at status and sense bytes returned from the commu- 
nication controller or the cluster controller for information that can help you deter- 
mine the location of the error condition. 


This appendix includes the following sections: 


e “Channel Programs for Channel-Attached Type 2 and 4 Physical Units” on 
page 874 


e “PUNS-Related Channel Programs” on page 880 


e “Channel Programs for Channel-to-Channel Adapters (CTCA), Multipath Chan- 
nels (MPC), and APPN Host-to-Host Channels” on page 881 


e “Channel Programs for Channel-Attached Non-SNA 3270 Devices” on 
page 899 


e “Channel Programs for a BSC Communication Adapter Line (VM) (VSE)” on 
page 904 


e “Channel Programs for an SDLC Communication Adapter Line (VM) (VSE)” on 
page 911. 
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Channel Programs for Channel-Attached Type 2 and 4 Physical Units 


The ICNCB represents type 2 and 4 physical units, and contains addresses and 
CCWs needed for channel programs. Figure 84 shows the following: 


e ICNCB 

e Location in storage of various CCWs 

e Write buffers required for writing three PIUs, each of which is contained in a 
single buffer. Write or Write-Break CCWs alternate with transfer-in-channel 
(TIC) CCWs. 


NCBCAW = address 
of the first CCW 
to be executed, 
(either a Write 


Write Buffers 


The number of Read buffers 
equals MAXBFRU. 


Figure 84. Data Areas Used by Channel Programs for PU Types 2 and 4 
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PU Types 2 and 4 


Channel Commands for Channel-Attached Type 2 and 4 Physical Units 


Table 53 describes the channel commands used by the VTAM program to write 
data to and read data from channel-attached type 2 and 4 physical units. 


Table 53 (Page 1 of 2). VTAM Channel Commands for Type 2 and 4 Physical Units 


Command 
Code 
(hex) 


01 


02 


03 


04 


08 


09 


31 


32 


51 


52 


Note: Data transfer does not occur 


61 


62 


Command 
Write 


Read 


No-op 


Sense 


TIC (Transfer 
in Channel) 


Write Break 


Write 
Start 0 


Read 
Start 0 


Write 
Start 1 


Read 
Start 1 


Write XID 


Read XID 
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Description 


Transfers data from storage in 
the host processor to the I/O 
device. 


Transfers data from the I/O 
device to storage in the host 
processor. 


Causes the channel to respond 
with a channel end and device 
end. It is the last CCW ina 
read or write chain. 


Transfers 1 or 2 bytes of sense 
data to storage in the host 
processor. 


Causes the channel to fetch an 
instruction that is not the next 
sequential instruction within the 
channel program sequence. 


Transfers data from storage in 
the host processor to the I/O 
device and indicates that it is 
the last or only Write command 
in a chain of Write CCWs. 


Begins a Write sequence. Alter- 
nates with Write Start 1. 


Begins a Read sequence. Alter- 
nates with Read Start 1. 


Begins a Write sequence. Alter- 
nates with Write Start 0. 


Begins a Read sequence. Alter- 
nates with Read Start 0. 


Contents of 
Address 
Field 


Output area 


Input area 


zero 


Address of sense 
data area 


Address of next 
CCW to be exe- 
cuted 


Output area 


Zero 


zero 


zero 


zero 


on Read-Start or Write-Start commands. 


The host sends the Write XID 
command to signal the NCP 
that a channel contact 
sequence is beginning and to 
prepare to receive the host's 
XID. 


The host sends the Read XID 
command to signal the NCP 
that the host expects to read 
the NCP’s XID. 
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Table 53 (Page 2 of 2). VTAM Channel Commands for Type 2 and 4 Physical Units 


Command Contents of 
Code Address 
(hex) Command Description Field 

A3 Discontact Indicates that the channel is no zero 


longer contacted and the 
attachment to the transmission 
group should be broken. 
Releases the PIUs on the 
channel hold and intermediate 
queues. 


C3 Contact Establishes contact between Zero 
the host and the NCP. Tells the 
NCP to use XID information for 
operations with the host. 


93 Restart Causes the controller to reset Zero 
its switches to indicate that the 
last Write-Start and Read-Start 
commands were Write-Start-1 
and Read-Start-1 commands. 


Format of Transfer-in-Channel (TIC) CCWs 
The Format 0 TIC CCW is formatted as follows: 


Byte (hex) Contents 

00 X'08' (TIC identifier) 
01-03 Real address 

04-07 Reserved. 


The Format 1 TIC CCW is formatted as follows: 


Byte (hex) Contents 

00 X'08' (TIC identifier) 
01-03 Zero 

04—07 Real address. 


A doubleword TIC extension immediately follows both the Format 0 TIC and the 
Format 1 TIC. VTAM uses the last 4 bytes of the TIC extension to contain the 
virtual address of the next buffer in the chain. 


The TIC extension is formatted as follows: 


Byte (hex) Contents 
08—OB Reserved 
OC-—OF Virtual address. 


For write buffers, the next to the last physical buffer is handled specially. The real 
address of the TIC points to the last Write-Break CCW (ICNWBCCW), but the 
virtual address points to the last write buffer that contains data (see Figure 85 on 
page 877.) This last buffer is formatted with a Write-Break CCW which is not used 
but is copied into ICNWBCCW. If only one buffer exists in the channel program, 
the Write-Start TIC is formatted so that the real address points to ICNWBCCW, but 
the virtual address points to the only write buffer. 
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Note that the last write buffer looks unusual because the Write-Break command is 
chained, but the next CCW. is zero. This Write-Break CCW is never physically exe- 
cuted by the channel, but the copied version of the CCW (in the ICNCB) is exe- 
cuted. 


Figure 85 shows the write buffers required for writing two PIUS when each spans 
three buffers. 


Write 
CCW 
lst 
PIU 
Write 
Break 
CCW 
2nd 
PIU 


CD = Chained Data bit on 


CC 
Figure 85. Format of Write CCWs with Chained Data 


Command Chaining bit on 


Channel Program Sequences 
The following describes the CCWs, in the order that they are executed, in a typical 
WRITE channel program. 


1. ICNWSCCW - Write Start: Each time a Write sequence (the Write start and all 
associated write buffers) has completed successfully, the Write-Start CCW is 
alternated: The first Write-Start operation code is X'31' (Write Start 0), the 
second Write-Start code is X'51' (Write Start 1), the third Write-Start code is 
X'31', and so on. There is no data transfer associated with this CCW; it is 
used to inform the controller that the previous Write has successfully com- 
pleted. 


2. ICNWSTIC - Write Start TIC: This CCW is used to chain to the first Write 
CCW. When the WRITE channel program consists of a single write buffer, the 
real address points to ICNWBCCW (the last Write Break). The virtual address 
of this CCW always points to the first write buffer on a chain or is zero when no 
WRITE channel program is pending or active for the device. 


3. Write or Write-Break CCWs Alternating with TICs: Figure 84 on page 874 
shows the write buffers required for writing threeWrite PiUs, each of which is 
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contained in a single buffer. Figure 85 shows the write buffers required for 
writing two PIUs, when each spans three buffers. — 


. ICNWBCCW CCW(3) - Last Write Break: |n a channel program this is the last 


Write CCW that is physically executed by the device. The data address points 
to the last write buffer that contains data. If a Read is requested, when this 
operation completes, the controller will signal a status modifier (in addition to 
channel end and device end). This causes ICNNPCCW to be skipped by the 
channel. 


. ICNNPCCW - No-Op: lf a Write completes and no Read is requested, No-Op 


is the ending CCW in a channel program. If a Read was requested, this CCW 
is skipped by the channel. The command chain flag will be on in this CCW ifa 
Read was previously requested but was not previously initiated, and read 
buffers are available. 


. ICNSMNOP - Status Modifier No-Op: This CCW receives control after the last 


Write Break if a Read is signaled. This CCW normally command chains to the 
Read Start so that writing and reading occur without interruption. If no buffers 
are available, however, the channel program ends here, and VTAM recognizes 
that a Read is required. 


. ICNRSCCW - Read Start: Each time a Read sequence_ (the Read Start and 


at least one Read) has completed successfully, the Read-Start CCW is alter- 
nated. 


The first Read-Start generation code is X'32' (Read Start 0), the second 
Read-Start generation code is X'52' (Read Start 1), the third Read-Start gen- 
eration code is X'32', and so on. 


As with the Write-Start CCW, there is no data transfer. The CCW alternation is 
used to inform the controller that the previous Read has successfully com- 
pleted. 


When a Write is not required, but a Read has been requested by an attention 
status,.Read Start is the first CCW in the channel program. 


. ICNRSTIC - Read Start TIC: This CCW is used to chain to the first Read 


CCW. The virtual address of this CCW points to the first read buffer on the 
chain, except: — 


e When deblocking PIUs, in which case the virtual address is changed by the 
channel end appendage. 


e When there are not enough read buffers available, in which case it is zero. 


. Read CCWs Alternating with TICs: Figure 84 on page 874 shows the buffers 


required for reading three PIUs. 


Read No-Op: This CCW should never be executed. If it is, it indicates that the 
controller and VTAM do not agree on how many read buffers are required. 


The normal ending status for a Read is channel end, device end, attention, or 
unit exception. The unit exception indication is presented on the Read CCW 
that has completed data transfer and terminates the command chaining. The 
attention indication is the same as the unit exception indication, but it also 
means that a Read is requested. 


Unit exception may also be presented to the Read-Start CCW. It is used by 
the controller to release input buffers. If the same Read Start (as opposed to 
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the alternate Read Start) is given to the controller, the data buffers must be 
re-sent. 
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PUNS 


PUNS-Related Channel Programs 


During activation of an NCP in a channel-attached communication controller, the 
SSCP sends a Contact RU to PUNS. PUNS responds by giving control to 
ISTTSCP4 to schedule one of five channel programs (A—E in Table 54). When the 
SSCP sends a Discontact RU to PUNS, one of two channel programs (F and G in 


Table 54) is executed. 


Table 54. PUNS-related Channel Programs 


CCW 
Sense 


Write XID 
No-Op 


Write Break 
Read XID 
Read 
No-Op 


Restart/Reset 
No-Op 


Contact 
Restart/Reset 
No-Op 


Discontact 
No-Op 


No-Op 


Code 
(hex) 


04 


61 
03 


09 
62 
02 
03 


93 
03 


C3 
93 
03 


A3 
03 


03 


Flags 
SLI 


SLI,CC 
SLI 


SLI,CC 
SLI,CC 
SLI,CC 
SLI 


SLI,CC 
SLI 


SLI,CC 
SLI,CC 
SLI 


SLI,CC 
SLI 


SLI 
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Notes 
Determines if the device needs to be loaded. 


This channel program follows A if the device 
does not need to be loaded. It is followed by 
either C or D. 


This channel program follows B if there is no 
command reject. 


Executed only if the Write XID in B caused a 
command reject (implies the NCP is NCP 
Release 2 or earlier). 


Restart/Reset is executed only if a Contacted 
(error) response is sent to PUNS. 


This channel program is executed only if B 
did not cause a command reject. 


This channel program is executed if B 
caused a command reject. 


These CCWs are contained in I/O buffers that are allocated from the IOBUF buffer 
pool when doing PUNS //O. 


The data area pointed to by the address portion of a Read XID or Write XID CCW 
is described in ISTXID in VTAM Data Areas for MVS/ESA and VTAM Data Areas 
for VM/ESA. 
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Channel Programs for Channel-to-Channel Adapters (CTCA), Multipath 
Channels (MPC), and APPN Host-to-Host Channels 


VTAM's CTC function supports two protocols: blocking and non-blocking. If VTAM 
is communicating with another VTAM through the CTC adapter and both VTAMs 
support the blocking protocol, blocking is the chosen protocol. If one VTAM does 
not support blocking protocols, the non-blocking protocol is used. 


You cannot specify the protocol choice during system definition. Because the 
blocking protocol is the preferred mode, it is used if both VTAMs support it. 


Channel Programs for Activating the CTC Connection 


Each side of a channel-to-channel adapter (CTCA) is represented by a cross- 
channel node control block (KCNCB). In addition, each side has a physical unit 
service I/O (PIO) control block and a station control block (SCB). The PIO is used 
for exchange ID (XID) channel programs (the physical unit services I/O that occurs 
before the link is active). The PIO is mapped by ISTPIO. The SCB is a station 
work area where CCWs for normal data transfer are built. It is not mapped, and is 
not described in VTAM Data Areas. 


A series of channel programs are issued when the operator activates the CTC con- 
nection. These I/O exchanges are used by the hosts to communicate various 
capabilities to the other host. The capabilities are transferred via the XID channel 
program. 


The three primary pieces of information gained through the XID exchange are: 


¢ Choice of protocol — blocking or non-blocking 
e¢ Determination of who is X-side and who is Y-side 
e \|/O buffering information to use once the connection is active. 


Protocol Choice 

As mentioned earlier, VTAM always chooses the blocking protocol if the partner 
VTAM is capable of supporting it. If the XID indicates it is not capable, the non- 
blocking protocol is used. 


X-Side / Y-Side 

Figure 86 on page 882 shows how VTAM determines which side will be the 
X-side and which side will be the Y-side. In this example, the operator in subarea 
4 is the first to activate the link. Subarea 4 begins as the X-side and then switches 
to the Y-side. 


//O Buffering 


During the XID exchange, each host informs the other about its read buffer capa- 


bility. 


In the blocking protocol, the total size of the single read buffer is communicated. 
The write buffer in the other host is allocated based on the size of the Read buffer. 


In the non-blocking protocol, the total number of read buffers available, as well as 
the size of each buffer, is communicated. Each host must then allocate the write 
portion of its channel program to match the read portion of the other host. 
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Subarea 4 Subarea 2 
SSCP PUNS TSC CTCA TSC PUNS 


V NET,ACT, 
——_—_—_—_—_——-»| ADDLINK 
ctcalinkname 


ACTLINK 


CONTACT 


XID0(2) 


XID7 (2) 
x1D7(4) 
x1D7(4) 


Figure 86. Example of an XID Exchange 


CTCA channel-to-channel adapter 

PUNS Physical unit services 

SSCP System services control point 

TSC Transmission subsystem component 


Note: (2) and (4) refer to Subarea 2 and Subarea 4. 

PUNS queues a RUPE to NCBPUPAB, causing TSC to get control. 

TSC posts PUNS. 

Subarea 4 assumes X-side protocols because it is initiating the XID exchange. 


Ey The XID exchange “times out’ because the link in subarea 2 has not been acti- 
vated. The CONTACT is issued in subarea 2, and upon attention, subarea 4 
assumes Y-side protocols. 


Assume the operator activates the link in subarea 2. Subarea 2 assumes 
X-side protocols. 


[J] The subarea with the lower subarea number (subarea 2) responds first to the 
XIDO exchange by sending an XID7. (XID7 is an XID Format 2 with the contact 
option field set to 7.) 
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Subarea 4 checks the XID7 from subarea 2 and responds with its XID7. It also 
sends a CONTACTED RU to the SSCP. 
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Channel Commands for Channel-to-Channel (CTC) Adapters 


Table 55 contains the channel commands used for channel programs between two 
hosts connected by a channel-to-channel adapter. 


Note: The Multipath channel (MPC) connection only uses these commands during 
activation and deactivation. For the channel commands used for data flow, when 
the MPC is in the CONTACTED-ACTIVE phase, see “Channel Programs for Multi- 
path Channel (MPC)” on page 895. 


Table 55 (Page 1 of 2). Channel Commands for Channel-to-Channel Adapters 


Command 

Code 

(hex) Command Description 

01 Write Transfers data from storage in this host 


processor to the CTC adapter (CTCA). For 
CTCAs this CCW is used to transfer status 
information from XCNOCTL, XID information 
from PIOPOTXT, validity checking information 
from XCNOVTXT, and data from buffers. 


Status information, mapped by XCNOCTL, is 
transferred in the first 8 bytes of the write 
buffer, and only one write buffer is used. 
Figure 89 on page 888 illustrates the buffer 
usage. 


For MPC connections this CCW, preceded by 
a Prepare command, is used to transfer data 
from the CPNCB transmit buffer. The transmit 
buffer is defined by YCNOBUF of the YCNCB 
contained within the CPNCB. The first 8 bytes 
of the transmit buffer is mapped by ISTBKHDR 
and contains control information about the 
current data transfer. Figure 95 on page 898 
illustrates the MPC buffers used for normal 
data transfer. 


02 Read Transfers data from the CTCA to this host 
processor. For CTCAs, this CCW is used to 
read status information into XCNICTL, XID 
information into PIOPITXT, validity checking 
information into XCNIVTXT, and data into 
buffers. 


Status information, mapped by XCNICTL, is 
transferred in the first 8 bytes of the read 
buffer, and only one read buffer is used. 
Figure 89 on page 888 illustrates the buffer 
usage. 


For MPC, this CCW is used to read normal 
data into the CPNCB transmit buffer. The 
transmit buffer is defined by YCNIBUF of the 
YCNCB contained in the CPNCB. Figure 95 
on page 898 illustrates the MPC buffers used 
for normal data transfer. 
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Table 55 (Page 2 of 2). Channel Commands for Channel-to-Channel Adapters 


Command 
Code 
(hex) 


03 


08 


14 


17 


43 


C3 


ES 


Command 
No-Op 


TIC 


Sense Command Byte 
(SCB) 


Write Control (WCTL) 


Enable Compatibility 
Mode (ECM) 


Disable Compatibility 
Mode (DCM) 


Prepare 


XID Channel Program (X-Side) 


Figure 87 on page 886 shows the data areas associated with the following XID 
channel program. 


Sequence 
1 


Command 
Code 
CCW (hex) 
Write 17 
Control 
TIC 08 
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Description 


Causes the channel to respond with a channel 
end or device end. It is the last CCW ina 
read or write chain. 


The No-Op command does not apply to the 
MPC connection. 


Causes the channel program to execute an 
instruction that is not the next sequential 
instruction within the channel program 
sequence. 


The TIC command does not apply to the MPC 
connection. 


The SCB is normally issued in response to an 
attention generated when the adapter proc- 
esses a WCTL from the other side. The SCB 
clears WCTL from the adapter, allowing the 
WCTL CCW to complete. 


Causes an attention interruption on the other 
side of the channel-to-channel adapter. The 
WCTL is issued to alert the other side that a 
channel program is active at the adapter. 


Prepares the adapter to operate in 
System/360* (compatibility) mode. The ECM is 
issued when VTAM gives up control of the 
adapter. 


Prepares the adapter to operate in 
System/370* (Extended) mode. The DCM is 
issued when VTAM acquires control of the 
adapter. 


Primes the CTC adapter for the next CCW. 
This CCW does not cause an attention on the 
other side of the adapter. 


The Prepare command applies only to the 
MPC connection. 


Byte 
Flags Address Count 
CC,SLI Zero 1 
— WRITE — 
CCW 
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Command 
| Code 
Sequence CCW (hex) | Flags Address 
3 Write 01 CC,SLI | XCNOCTL 
4 Write 01 CC,SLI PIOPOTXT 
5 TIC 08 — READ 
CCW 
Read 02 CC,SLI XCNICTL 
Read 02 CC,SLI PIOPITXT 
TIC 08 — READ 
CCW 
9 Read 02 CC,SLI XCNOVTXT 


NCBCAW Write (status) CCW 


ae <a 


Write Control CCW Read (status) CCW 


Read (XID) CCW 
TIC 
Read (VALCHECK) CCW 


—» = Transfer in Channel 


Figure 87. Data Areas Used for XID Channel Programs (X-Side) 


XCNCB P10 


XID Channel Program (Y-Side) 


Byte 


Count 
8 
Length of XID 


8 
Length of XID 


4 


Figure 88 on page 887 shows the data areas associated with the following XID 


channel program. 


Command 
Code 
Sequence CCW (hex) Flags Address 
1 Sense 14 CC,SLI Zero 
Command 
Byte 


Byte 


Count 
1 
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Command : 
| Code Byte 
Sequence CCW (hex) Flags Address Count 
2 TIC 08 — READ — 
CCW 
Read 02 CC,SLI XCNICTL 8 
Read 02 CC,SLI PIOPITXT Length of XID 
5 TIC 08 — WRITE — 
CCW 
Write 01 CC,SLI XCNOCTL 8 
Write 01 CC,SLI PIOPOTXT Length of XID 
8 TIC 08 Ss WRITE — 
CCW 
9 Write 01 CC,SLI SCNOVTXT 4 
XCNCB 


NCBCAW 


1 Sense Command Byte 
CCW 


Write (status) CCW 


Write (XID) CCW 


: 
Read (status) CCW 
Read (XID) CCW 


TIC 


PIO 


Write (VALCHECK) CCW 
— >» = Transfer in Channel 


Figure 88. Data Areas Used for XID Channel Programs (Y-Side) 


Channel Programs for CTC Data Transfer: (Blocking Protocol) 


MAXBFRU defines a single read buffer. The write buffer in the other host is allo- 
cated to be the same size. PiUs are blocked for transfer, and are written by a 


single write, and read by a single read. 


VTAM only uses three CCWs in its Data Transfer channel program: a Write CCW, 
a Read CCW, and another that is either a WCTL CCW or an SCB CCW. Output 
control information is included within the write buffer and input control information is 


received in the first bytes of the read buffer. 
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Normal data transfer for channel programs is a Write CCW followed by a Read 
CCW (on the X-side) or a Read CCW followed by a Write CCW (on the Y-side). 
VTAM uses the procedure described in “Channel Programs for Activating the CTC 
Connection” on page 881 to determine which side will be X and which will be Y. 


During the XID exchange, each host informs the other host of the size (in pages) of 


the buffer that will be used in the read portion of its channel programs. Each host 
then allocates a write buffer to match exactly the read buffer of the other host. 


(1) 


Read 
Buffer — 
YCNIBUF 
YCNOBUF 
(2) 
Write 
Buffer 


Figure 89. Buffers Used for Normal Data Transfer 


The numbers 1 and 2 in Figure 89 represent: 


(1) The first 8 bytes of the read buffer is the control information mapped by 
XCNICTL. 


(2) The first 8 bytes of the write buffer is the control information mapped by 
XCNOCTL. 


Normal Data Transfer (X-Side) 
Figure 90 on page 889 shows the data areas associated with the X-side of a 
normal data transfer channel program. 


Command 

Code Byte 
Sequence CCW (hex) Flags Address Count 
1 WCTL2 17/ CC,SLI Zero 1 

14 | 


Note: 2 WCTL is used when this host is initiating a write operation. SCB is used when this 
host is responding to an attention (because the other host has data that it wants this host to 


read). 

2 Write 01 CC,SLI YCNWRIDA Number of bytes to 
transfer 

3 Read 02 SLI YCNRDIDA Total length of Read 
buffer 
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YCNCB 


WRITE CCW 
YCNCCWWR 


(02) 
WATE 


READ CCW 
YCNCCWRW 


List of pointers to 
2K increments of 
write buffers 


YCNWRIDA 
PURO RROAAUAGAOOREROROUROROER 
DORR OAORUORRERRORORORREOROER 


YCNRDIDA 
HTT 
POTD RROORORORORRRROROROOROER 


List of pointers to 
2K increments of 
read buffers 


Figure 90. Data Areas Used for Normal Data Transfer (X-Side) 


Normal Data Transfer (Y-Side) 
Figure 91 on page 890 shows the data areas associated with the following normal 
data transfer channel program. 


Command 


Code Byte 
Sequence CCW (hex) Flags Address Count 
1 WCTL? 17/ CC,SLI Zero 1 

14 


Note: 3? WCTL is used when this host is initiating a write operation. SCB is used when this 
host is responding to an attention (because the other host has data that it wants this host to 


read). 

2 Read 02 CC,SLI YCNRDIDA Total length of Read 
buffer 

3 Write 01 SLI YCNWRIDA Number of bytes to 
transfer 
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YCNCB 


WRITE CCW 


YCNCCWWR 


(02) 
MTT 


READ CCW 
| YCNCCWRW 


I} | |J>|  YONWRIDA 
RUUURRRRRARREAORROERORROERRE 


WT 


List of pointers to 
2K increments of 
Read buffers 


YCNRDIDA 
HEE 
HTT 


List of pointers to 
2K increments of 
Write buffers 


Figure 91. Data Areas Used for Normal Data Transfer (Y-Side) 


Channel Programs for Channel-to-Channel Adapters: 
Non-Blocking Protocol 

MAXBFRU defines the total number of IOBUF sized read buffers to use to receive 
data from the CTC. Consequently, the channel program is a series of writes fol- 
lowed by a series of reads for the X-side. For the Y-side, it is a series of reads 
followed by a series of writes. 


Normal Data Transfer (X-Side) for Non-Blocking Protocols 
Figure 92 on page 892 shows the data areas associated with the X-side of a 
normal data transfer channel program for non-blocking protocols. 


Command 

Code Byte 
Sequence CCW (hex) Flags Address Count 
1 WCTL4 17/ CC,SLI Zero 1 

14 


Note: 4 WCTL is used when this host is initiating a write operation. SCB is used when this 
host is responding to an attention (because the other host has data that it wants this host to 


read). 
2 TIC 08 — WRITE — 
CCW 
Write 01 CC,SLI XCNOCTL 8 
TIC 08 — WRITE — 
Write 01 CC,SLI oe Length of data in 
(CD) Buffer this buffer 
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Sequence CCW 
5 Write 
Write 
6 TIC 
Read 
TIC 
Read 
9 TIC 
Read 
TIC 
10 Write 
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Command 
Code 
(hex) 


01 
01 


02 


08 


01 


Flags 


CC,SLI, 
(CD) 


~CC,SLI 


CC,SLI 


CC;SLI 


CC,SLI 


CC,SLI 


Address 
Buffer 


Buffer 


READ 
CCW 
XCNICTL 


READ 
CCW 


Address 
of Data 


READ 
CCW 


Address of 
Data 


WRITE 
CCW 


XCNOVTXT 


Appendix D. Channel Programs 


Byte 


Count 


Length of data in 
this buffer 


Length of data in 
this buffer 


Length of data in 
this buffer 


Length of data in 
this buffer 
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WRITE CCW 
WRITE CCW 


WRITE CCW | 
TIC 


——» = Transfer in Channel 


Figure 92. Data Areas Used for Normal Data Transfer (X-Side) Non-Blocking 


Normal Data Transfer (Y-Side) for Non-Blocking Protocols 
Figure 93 on page 894 shows the data areas associated with the Y-side of the 
following normal data transfer channel program for non-blocking protocols. 


Command 
Code Byte 
Sequence CCW (hex) Flags Address Count 
1 WCTLS5 14/ CC,SLI Zero 1 
| 17 


Note: 5 WCTL is used when this host is initiating a write operation. SCB is used when this 
host is responding to an attention (because the other host has data that it wants this host to 


read). 
2 TIC 08 — READ — 
CCW 
Read 02 CC,SLI XCNICTL 8 
TIC 08 — READ — 
CCW 
Read 02 CC,SLI Address Length of data in 
of Data this buffer 
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Command 
Code Byte 
Sequence CCW (hex) Flags Address Count 
TIC 08 — READ — 
CCW 
5 
Read 02 CC,SLI Address Length of data in 
of Data this buffer 
TIC 08 — WRITE — 
CCW 
Write 01 CC,SLI XCNOCTL 8 
TIC 08 — WRITE — 
CCW 
Write 01 CC,SLI, Buffer Length of data in 
(CD) this buffer 
8 Write 01 CC,SLI, Buffer Length of data in 
(CD) this buffer 
Write 01 CC,SLI Buffer Length of data in 
this buffer 
9 | TIC 08 — READ — 
CCW 
10 Read 02 CC,SLI XCNIVTXT 4 
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SCB | 
WRITE CCW 
WRITE CCW 


| WRITE CCW 
TIC 


Figure 93. Data Areas Used for Normal Data Transfer (Y-Side) Non-Blocking 
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Channel Programs for Multipath Channel (MPC) 
VTAM's MPC function is derived from the VTAM channel-to-channel (CTC) function. 
Both MPC and CTC communicate with the CTC Adapter, but MPC uses its own set 
of channel programs. 


During normal data transfer, MPC uses the 'never-ending' Read channel program. 
This means that a subchannel defined as a Read device can have an outstanding 
Read channel program or can be processing the last channel program to complete. 
On subchannels defined as Write devices, a Write channel program is generated 
when data is available to be written to the CTC adapter. 


The following sections describe the multipath channel programs for activating or 
deactivating an MPC connection as well as for normal data transfer. 


Channel Programs for Activating the MPC Connection 


A series of channel programs is issued when the operator activates the MPC con- 
nection. These I/O exchanges are used by the hosts to communicate various 
capabilities to the other host. The capabilities are transferred using the XID 
channel program. 


The primary pieces of new information gained through the MPC XID exchange are: 


e MPC to CTC connection 
e Polarity of the device (Read or Write) 
e 1/O buffering information for an active connection. 


Channel Program (X-Side or Y-Side) 
Unlike CTCA, X-Side or Y-Side has meaning only during XID exchange for MPC. 


Figure 94 on page 896 shows how VTAM determines which side is the X-side and 
which side is the Y-side. 


In this example, the operator in subarea 1 is the first to activate the link. Because 


subarea 2 is not active, the XID exchange does not complete. Later, when the 
operator in subarea 2 activates the link, the XID exchange is completed. 


VO Buffering 


During the XID exchange, each host informs the other about its read buffer size. 
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SUBAREA 2 SUBAREA 1 


SSCP PUNS TSC CTCA1 CTCA2 CTCA3 TSC PUNS 


ADDLINK 


ACTLINK 
ACTLINK 


CE/DE 
DCM 
CE/DE 
DCM 
CE/DE : : 
+RESP ——__-__--——.. 
CONTACT 
X1D0(2) 4 | 
XID0(2) 
X1D0(2) 
X1D0(2) 
CONTACT 
. : : (from SSCP) 
Time out . : : G XID0(1) 
; X1D6(1) 
sea mame 
X1D6(2) 
X1D0(1) 
X1D0(2) ‘ | 
—_—————— 
; : X1D@(1) 
+ 3 OO, 
X1D0(2) ; 
OO 
XID0(1) , : . XID6(2) 
: X1D7(1) 
, ; .  XID7(1) 
—_—— nk k — eee, 
i : .  XID7(1) 
—_—_—_—_——___, 
: ‘ X1D7(1) 


XID7(1) ——_——_—, 


XID7(2) 
X1D7(2) 


X1D7 (2) 
X1D7 (2) 


CONTACTED 


Figure 94. MPC Activation Flow 


CTCA channel-to-channel adapter 

PUNS Physical unit services 

SSCP System services control point 

TSC Transmission subsystem component 


Note: When MPC is used for an APPN host-to-host channel connection, the flows 
between the SSCP, PUNS, AND TSC components differ somewhat from those in 
this figure. The XID flows are the same. 
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PUNS queues an ACTLINK RUPE to the MPNCB PUPAB, causing TSC to 
get control. 


TSC issues a DCM channel program on every device in the MPC group. 


A single ACTLINK response is passed to PUNS and SSCP indicating that 
the MPC path ACTLINK initialization is completed. 


[Jj PUNS XIDO is copied to all MPC subchannels so that they are being 
written to all MPC subchannels. In this case, subarea 2's XIDOs are timed out 
and the other side is not ready to read. 


Assume the operator activates the link in subarea 2. Subarea 2 assumes 
X-side protocols. 


[J Subarea 1 initiates writing XIDOs at all MPC subchannels and then com- 
pletes. 


The subarea with the lower number (Subarea 1) responds first to the XIDO 
exchange by sending an XID7. 


EE] Subarea 2 checks the XID7 from subarea 1 and responds with its XID7. It 
also sends a CONTACTED RU to the SSCP. 


Channel Commands for Activating the MPC Connection 


See “Channel Commands for Channel-to-Channel (CTC) Adapters” on page 884 
for the commands used for activation and deactivation of the MPC connection. 


The MPC XID channel programs are identical to the CTC packed format XID 
channel programs. See “XID Channel Program (X-Side)” on page 885 and “XID 
Channel Program (Y-Side)” on page 886. 


Channel Programs for MPC Data Transfer 
‘ MAXBFRU defines a single read buffer. The write buffer in the other host has the 
same size allocation. PlUs are blocked for transfer, and are written by a single 
write, and read by a single read. 


VTAM uses three CCWs in its data transfer channel program: 


e Write CCW 
e Read CCW 
e Prepare CCW 


MPC unique output control information is in the write buffer and input control infor- 
mation is received in the first 8 bytes of the read buffer. 


Normal data transfer for channel programs is a PREP CCW followed by a Write 
CCW (Write device) or a Prepare CCW followed by a Read CCW (Read device). 


During the XID exchange, each host passes buffer size information for the read 


portion of its channel programs to other hosts in the network. Each host allocates 
a write buffer to match the other host's read buffer. 
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YCNCB 
YCNIBUF 
YCNOBUF 


Figure 95. MPC Transmit Buffers Used for Normal Data Transfer 


Read 


Buffer 


Write 


Buffer 


1. The first 8 bytes of the channel buffer is the control information mapped by 
ISTBKHDR. 


YCNCB 


PREPARE CCW 
WRITE CCW (01) 


PREPARE CCW 
READ CCW (02) 


List of pointers to 
2K increments of 
Write buffers 


YCNWRIDA 
HET 
PURUREROARRA SOR OORERORROROEL 


OR 


YCNRDIDA , 
HEE 
HTT 


List of pointers to 
2K increments of 
Read buffers 


Figure 96. Indirect Address Word Structure of Multipath Channel Programs for Normal Data 
Flow 
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Channel Programs for Channel-Attached Non-SNA 3270 Devices 


The publications for the non-SNA 3270 devices contain diagnostic procedures. For 
more information, see the documentation for your display type, or for your control 
unit. See Table 80 on page 1165 to determine what book contains information on 
the 3174 controller. 


The LDNCB represents local devices and contains addresses and CCWs needed 
for channel programs. Figure 97 shows the LDNCB and the location in storage of 
various CCWs. 


LDNCB 


NCBCAW 
LDNSLCCW 
(Select CCW) 
LDNTICCW 
(TIC CCW) 


Address * Only when there is 
of Active a Select CCW 
Request an LDNACREQ 

Elements 


Read 

Buffer + LDNRBLEN 
Length 

Read 

Modi fied { 
Length 


LDNRMLEN 


Figure 97. Data Areas Used by a Channel Program for Channel-Attached Non-SNA Devices 
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Table 56 contains the channel commands used by VTAM to send data to and 
receive data from channel-attached non-SNA 3270 terminals. 
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Table 56. Channel Command Words for Channel-Attached Non-SNA 3270 Devices 


Command 
Code 
(hex) 

01 

02 

05 

06 


OB 


OD 
1B 
4B 
OF 


11 
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Command 
Write 


Read or 
Read buffer 


Erase/Write 


Read Modified 


Select 


erase/write 
Alternate 


Select Read 
Buffer 


Select Write 


Erase All 
Unprotected 


- Write 


Structured 
Field 


Description 


Transfers data from storage in the host processor 
to the I/O device. Modifies existing buffer data. 


Transfers the entire buffer contents from the 1/O 


device to storage in the host processor. 


Clears the device buffer before starting the write. 


Transfers data (that was modified since the last 
read) from the I/O device to storage in the host 
processor. 


Transfers data from the I/O device buffer to the 
controller buffer. Separates the device-to- 
controller unit buffer transfer from the execution 
command. 


Same as Erase/Write, except that it allows for a 
larger buffer size required for some devices. 


Same as Select, except that it is only used for 
Read buffer channel programs. 


Same as Select, except that it is only used for 
Write channel programs. 
Clears all unprotected buffers 


Writes a structured field 
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Channel Programs 


Table 57 through Table 62 on page 903 show the CCWs used in various channel 
programs. The order of execution is the same as the order in which they appear. 


Write Data Channel Program 
Table 57. Write Data Channel Program 


Command 
Code Byte 
CCW (hex) Flags Address Count 
Select OB or 4B? CC,SLI Zero 1 
TIC | 08 — Write CCW — 
Write?0 01 CD,SLI Output Area Length of data 
(As many as 
needed) 


Read Modified Channel Program 
Table 58. Read Modified Channel Program 


Command 
Code Byte 
CCW (hex) Flags Address Count 
Select 0B CC Zero 1 
TIC 08 — Read Modified — 
CCW 
Read 06 CD Input Area Length of data 
Modified"! | 
(As many as 
needed) 
TIC 08 — | Read Modified — 
CCW 
Read 06 CD Input Area Length of data 
Modified’ 
Read 06 SKIP Zero X'7FFEF' 
Modified 
(Skip) 


9 If the UCB indicates that the device will accept the Select Write, code X'4B', it is used until a command reject is received. Then 
Select, code X'0B', is used. | 

10 The first Write CCW is pointed to by LDNACREQ. 

11 The first Read Modified CCW is pointed to by LDNACREQ. 

12 The number of bytes transmitted in the previous Read Modified CCW is stored in the LDNRMLEN field in the LDNCB. For this 
Read Modified, enough buffers are allocated to hold LDNRMLEN bytes of data. If this is not enough buffers for the device to send 
all of the pending data, the channel program will end on the Read Skip CCW. The Read Skip CCW reads all of the pending data 
but does not transmit any of it. The new length is stored in LDNRMLEN. (The length is computed by subtracting the residual byte 
count in the CSW from X'7FFF'.) Then the channel program is executed again with one more buffer than necessary allocated to 
read and transmit all of the pending data. 
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Read Buffer Channel Program 
Table 59. Read Buffer Channel Program 


Command 
Code Byte 
CCW (hex) Flags Address Count 
Select OB or CC,SLI Zero 1 
1B13 
TIC 08 — Read buffer — 
CCW 
Read 02 CD Input Area Length of data 
Buffer'4 
(As many as 
needed) 
TIC 08 — Read buffer — 
CCW 
Read 02 CD Input Area Length of data 
Buffer's 
Read 02 SKIP Zero X'7FFF' 
Buffer 
(Skip) 
Erase/Write Channel Program 
Table 60. Erase/Write Channel Program 
Command 
Code Byte 
CCW (hex) Flags Address Count 
Erase/ 05 CD,SLI Output Area Length of data 
Write'6 
(As many as 
needed) 
TIC 08 — Erase/Write _ 
CCW 
Erase/ 05 SLI Output Area Length of data 
Write 


13 If the UCB indicates that the device will accept the Select Read, code X'1B', it is used until a command reject is received. Then 
Select, code X'0B', is used. 

14 The first Read CCW is pointed to by LDNACREQ. 

15 The number of bytes transmitted in the previous Read buffer CCW is stored in the LDNRBLEN field in the LDNCB. For this Read 
buffer, enough buffers are allocated to hold LDNRBLEN bytes of data. If this is not enough buffers for the device to send all of 
the pending data, the channel program will end on the Read Skip CCW. The Read Skip CCW reads ail of the pending data but 
does not transmit any of it. The new length is stored in LDNRBLEN. (The length is computed by subtracting the residual byte 
count in the CSW from X'7FFF'.) Then the channel program is executed again with oon buffers allocated to read and 
transmit all of the pending data. 


16 LDNACREQ has the address of the first Erase/Write CCW. 


902 VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” Non-SNA 3270 Devices 
Licensed Materials — Property of IBM 


Erase/Write Alternate Channel Program 
Table 61. Erase/Write Alternate Channel Program 


Command 
Code Byte 
CCW (hex) Flags Address Count 
Erase/ OD CD,SLI Output Area Length of data 
Write?” , 
Alternate 
(As many as 
neededg) 
TIC 08 — Erase/Write —_ 
Alternate 
CCW 
Erase/ OD SLI Output Area Length of data 
Write 
Alternate 


Erase All Unprotected Channel Program 
Table 62. Erase All Unprotected Channel Program 


Command 

Code Byte 
CCW (hex) Flags Address Count 
Erase All'8 OF SLI Zero 1 


Unprotected 


17 LDNACREQ contains the address of the first Erase/Write Alternate CCW. 
18 LDNACREQ contains the address of the Erase All Unprotected CCW. 
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Channel Programs for a BSC Communication Adapter Line (VM) (VSE) 


The BSC line control block (BSCLB) represents a BSC line attached through a BSC 
communication adapter and contains addresses and CCWs needed for channel 
programs. See Table 80 on page 1165 to determine what books contain detailed 
descriptions of channel programs, the interface between VTAM and the telecommu- 
nications subsystem controller or communication adapter, and the sense codes 
returned from a telecommunications subsystem controller or communication 


adapter. 


Channel Commands 


The following channel commands are used by VTAM to write data to or read data 
from a BSC terminal attached through a communication adapter line. Of the 
channel commands supported by the BSC communication adapter, VTAM only 
uses those required for master-station multipoint operations. 


Command 
Code 
(hex) 

01 

02 

03 


04 
08 


09 
23 
27 


2F 


Command 
Write 


Read 

No-Op 

Sense 

TIC (Transfer 


in Channel) 


Poll 
Set Mode 


Enable 


Disable 


Description 


Transfers data from storage in the host processor to 
the BSC device. 


Transfers data from the control unit to storage in the 
host processor. 


Used to stop channel program execution (for example, 
General Poll). It also causes the channel to respond 
with a channel end and device end. 


Transfers two bytes of sense data to VTAM. 


Requests a transfer in the channel program. It causes 
the channel program to execute a command other than 
the next sequential command in the channel program. 


Starts the autopoll of the poll list at the entry specified. 


Used to condition a line in an Enable WRITE channel 
program. It sets the desired operating environment. 


Sets the BSC line to the enabled state. It is the last 
command in an Enable WRITE channel program. 


Sets the line to the disabled state. It is a part of the 
Enable Write and Disable channel programs. 


/O Scheduling Overview of BSC Lines 
During activation of a BSC line, a polling list is constructed containing entries for all 
of the BSC cluster controllers that are defined for the line. Initially, all the poll list 
entries are inactive and no //O is started. : 


At the time a Contact RU is processed for the cluster controller, activation proc- 
essing activates the appropriate polling list entry and, if it is the first cluster on the 
line to be activated, causes the General Poll channel program to be started. The 
General Poll channel program is designed to run continuously, without interruption, 
as long as negative responses to poll (EOTs) are being received. When an inter- 
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ruption occurs, VTAM analyzes the non-negative response to determine the next 
action. 


Normally, it would be a Continue READ channel program to acknowledge the pre- 
vious response and to Solicit the next transmission. The Continue READ channel 
program is issued repeatedly until an EOT is received that indicates that the cluster 
controller has completed its data transmission. 


Upon receipt of an EOT, the station pending traffic queues are checked for pending 
output to any active terminal on the line. If any is found, that transmission is 
scheduled prior to restarting the General Poll. Any pending activation or deacti- 
vation of polling list entries is done at this time as well. 


If output I/O, activation, or deactivation occurs while the General Poll is active, but 
prior to an interruption, the General Poll is stopped to allow this processing to 
proceed. This is accomplished in a controlled manner by changing the TIC (the 
sixth command) in the General Poll channel programs to a No-op. Changing the 
TIC to No-op causes the channel program to end when it has polled all entries in 
the polling list. 


Following completion of any scheduled operations, the General Poll is restarted at 
the first entry in the polling list. If General Poll is restarted after the completion of a 
General Poll, it is restarted at the next entry from the one that caused the General 
Poll to be completed. This ensures an even distribution of poll operations among 
the cluster controllers on a line. 


Channel Programs 
The following channel programs are used in the I/O sequence that sends data to or 
receives data from a BSC terminal. 


Note: Except for the Enable Write and Disable WRITE channel programs, all of 
the channel programs (or portions of them) are in the BSC line control block 
(BSCLB). 


Enable WRITE Channel Program 


This channel program is started for ACTLINK processing in order to condition and 
enable the line. 


Command 
Code Byte 
Sequence CCW : (hex) - Flags | Address Count 
(1) Disable 2F CC,SLI — 1 
(2) Set Mode 23 CC,SLI Control 1 
Informa- 
tion 
(3) Enable 27 SLI — 1 
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Disable WRITE Channel Program 


This program is started for DACTLINK processing in order to disable a line. 


Command 

Code Byte 
Sequence CCW (hex) Flags Address Count 
(1) Disable 2F SLI — 1 


General Poll (Initial Read) Channel Program 


To solicit data from BSC terminals, this program is constructed to allow polling to 
begin with any entry in the poll list and to continue wrapping through the list until: 


e A non-negative response is received from a terminal. 
e The channel program is stopped for the scheduling of output. 
e The operations terminate. / 


The program is also updated dynamically to reflect a changed poll list entry, poll list 
length, or read data area. When this program is initiated, the BSCOCFSM, 
BSCPCFSM, and BSCCCFSM fields of the BSCLB are set to X'01'. 


Command 
Code . Byte 
Sequence CCW (hex) Flags Address Count 
(1) Write 01 CC,SLI EOT 1 
(2) Poll 09 CC,SLI Poll list no +1 
entry 
(3) TIC 08 — Command 1 
(5) 
(4) TIC 08 — Command 1 
ae eee, (/ 
(5) Poll 09 CC,SLI First entry m20 + 4 
. poll list 
(6) TIC 08 — Command 1 
a 
(7) Read 02 SLI /O buffer Length of 


data 


Note: The numbers in the Address column refer to the numbers in the Sequence 
column. 


19 1 is the number of stations left after the last one to respond, times the length of the BSC polling list entries. 
20 m is the number of stations on the polling list, times the length of the BSC polling list entries. 
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Continue READ Channel Program 
This program is used after either an Initial READ channel program or another Con- 
tinue READ channel program. It sends a positive acknowledgment to previously 


received data and reads in additional data. When this program is executing, the 
BSCOCFSM, BSCCPFSM, and BSCCCFSM fields of the BSCLB are set to X'02'. 


Command 
Code Byte 
Sequence CCW (hex) Flags Address Count 
(1) Write 01 CC,SLI ACKO or 2 
ACK1 
(2) Read 02 SLI I/O buffer Length of 


data 


Repeat READ Channel Program 


During error recovery procedure (ERP) for BSC lines, this channel program is exe- 
cuted to request that the terminal retransmit the previous text block in which a 
“block check” error was detected. At this point, the BSCOCFSM, BSCPCFSM, and 
BSCCCFSM fields of this BSCLB are set to X'0B'. 


Command 
| Code Byte 
Sequence CCW (hex) Flags Address Count 
(1) | Write 01 CC,SLI NAK 1 
(2) Read 02 SLI I/O Buffer Length of 


data 


Interrupt WRITE Channel Program 


When the inbound data flow must be stopped immediately, the Interrupt WRITE 
channel program is used to stop the General Poll (Initial Read) channel program. 
In order to prevent data loss, the channel program is executed following a text 
block that ends with ETX. The BSCCCFSM and BSCPCFSM fields of the BSCLB 
are set to X'0C'. | 


Command 

Code Byte 
Sequence CCW (hex) Flags Address Count 
(1) Write 01 CC,SLI RVI 2 
(2) Read 02 SLI Response 2 


area 


Reset WRITE Channel Program 


The Reset WRITE channel program is used to write an EOT to the terminal and to 
return the line to control mode. When this program is executing, the BSCCCFSM 
and BSCPCFSM fields of the BSCLB are set to X'07'. 
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Command | | 

Code Byte 
Sequence CCW _ (hex) Flags _ Address Count 
(1) Write 01 SLI EOT 1 


Status READ Channel Program 


The Status READ channel program is executed when a terminal indicates that it 
has pending BSC sense/status information. The program specifically polls the ter- 
minal and reads the BSC sense/status information only. The BSCCCFSM and 
BSCPCFSM fields of the related BSCLB are set to X'0A'. 


Command | 
Code Byte 
Sequence CCW (hex) Flags Address Count 
(1) Write 01 CC,SLI EOT 1 
(2) | Write 01 CC,SLI Specific 5 
| poll char- 
acters 


(3) Read 02 SLI ‘YO buffer Length of 
data 


ney READ Channel Program 
The Inquiry READ channel program clears a communication adapter line buffer. 
Any data read is discarded because of the skip flag in the program’s Read CCW. 
The BSCCCFSM and BSCPCFSM fields of the BSCLB are set to X'0D'. 


Command 

Code Byte 
Sequence CCW (hex) Flags Address Count 
(1) Read 02 SLI,SKIP Response 4095 


area 


Sense Channel Program 
The Sense channel program is issued when VTAM receives unit-check status from 
the communication adapter. 


Command 

Code Byte 
Sequence CCW (hex) Flags Address Count 
(1) Sense 04 SLI Sense 2 


area 
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BSC Communication Adapter Line 


Initial Write (Conversational) Channel Program 


A variation of the Initial WRITE channel program, the Initial Write (Conversational) 
channel! program performs a required conversational function. This function allows 
a terminal to respond to a text block with another text block, rather than with a 
response. The channel program must have an appropriate length buffer ready to 
receive the text block. The BSCOCFSM, BSCCCFSM, and BSCPCFSM fields of 
the BSCLB are set to X'08' when an Initial Write (Conversational) channel 
program is executing. They are set to X'04' when an Initial WRITE channel 
program is executing. 


Command 
Code Byte 
Sequence CCW (hex) Flags Address Count 
(1) Write 01 CC,SLI EOT 1 
(2) Write 01 CC,SLI Selecting char- 5 
acters 
(3) Read 02 SLI Response area 
(4a) Write 01 CD,SLI STX ESC char- 
acters 
(4b) TIC 08 — Command (4c) 1 
in 1/O buffers 
(4c) Write 01 CD,SLI Data in I/O Length of 
buffer data 
(4d) TIC 08 — Command (4e) 1 
(4e) Write 01 CC,SLI ETX character 1 
(5a) Read 02 SLI Response area 2 
(5b) Read 02 SLI I/O buffers Length of 
data 


Inquiry Write (Conversational) Channel Program 


The Inquiry Write (Conversational) channel program is issued during ERP (error 
recovery procedure) in order to request the terminal to retransmit its last response. 


The BSCCCFSM and BSCPCFS&M fields of the BSCLB are set to X'06'. 


Sequence 
(1) 

(2a) 

(2b) 


CCW 
Write 
Read 
Read 
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Command 
Code 
(hex) 


01 
02 
02 


Flags 
CC,SLI 
SLI 

SLI 


Address 

ENQ 
Response area 
I/O buffer 


2 


Length of 
data 
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Channel Program Finite State Machines for BSC Lines 


The finite state machine (FSM) represents what is happening on the BSC line. 
Table 63 shows the finite state machines and what they mean. 


Table 63. Channel Program Finite State Machines for BSC Lines 


FSM 
(1) GP 
(2) CR 
(3) CM 


(4) IW1 
(5) lw2 


(6) INQ 
(7) EOT 
(8) IC1 


(9) IC2 


(10) STR 
(11) RR 

(12) IWT 
(13) IQR 
(14) |QW 
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State 

General Poll 
Continue Read 
Control Mode 


Initial Write 1 


Initial Write 2 


Inquiry Write 
End of Transmission 


Initial Write Conver- 
sational 1 


Initial Write Conver- 
sational 2 


Status Read 
Repeat Read 
Interrupt Write 
Inquiry Read 


Inquiry Write Con- 
versational 


Explanation 
The General Poll channel! program is executing. 
The Continue READ channel program is executing. 


The BSC line is in control mode. No channel 
program is executing for the line. 


The first part of an Initial WRITE channel program is 
executing. 


The second part of an Initial WRITE channel 
program is executing. 


An Inquiry WRITE channel program is executing. 
An EOT has been sent, or an EOT is expected. 


The first part of an Initial Write (Conversational) 
channel program is executing. 


The second part of an Initial Write (Conversational) 
channel program is executing. 


A Status READ channel program is executing. 


A Repeat READ channel program is executing. 


_ An Interrupt WRITE channel program is executing. 


An Inquiry READ channel program is executing. 


An Inquiry Write (Conversational) channel program is 


executing. 
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SDLC Communication Adapter Line 


Channel Programs for an SDLC Communication Adapter Line (VM) 


(VSE) 


The HALCB represents an SDLC line attached through an SDLC communication 
adapter and contains addresses and CCWs needed for channel programs. See 
Table 80 on page 1165 to determine what books contain detailed descriptions of 
channel programs, the interface between VTAM and the telecommunications sub- 
system controller or communication adapter, and the sense codes returned from a 
telecommunications subsystem controller or communication adapter. 


Channel Commands 


The following channel commands are used in the channel programs to communi- 
cate with SNA devices on SDLC lines or with the SDLC lines themselves. 


Command 
Code 
(hex) 

01 

02 


03 
05 


06 


08 


09 


OB 


OF 


14 


Command 
Write 


Read 


No-op 
Write PIU 


Read PIU 


TIC 
(Transfer 
in 
Channel) 
Autopoll 


Control SCB 
(Control SPL) 


Poll 


Sense SCB 
(Sense SPL) 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


Description 


Writes an SDLC command located in the 
TSCODATA field of the TSCB. 


Reads an SDLC command or control data located 
at TSCIDATA. 


Used to stop channel program execution. 


Points to TSCILNG, a two-byte prefix to TSCPIU. 
TSCILNG contains the total length of the data in 
the PIU. This length includes the TH, RH, RU, 
and TSCILNG. Data in any continuation buffers 
for the Write PIU channel program will start at 
TSCPIU as usual. 


Points to TSCILNG, a two-byte prefix of TSCPIU. 
The total length of the data is returned in 
TSCILNG. Data in any continuation buffers of the 
Read PIU channel program begins at TSCILNG. 


Requests a transfer in the channel program. It 
causes the channel program to execute a 
command other than the next sequential 
command in the channel program. 


Points to a polling list of SCBs. The length is the 
length of the polling list. This command solicits 
input from active stations, contact polls those 
stations being activated, and ignores the inactive 
stations. 


Transfers 12 bytes of SCB information from 
VTAM to the communication adapter. 


Transfers a final RR or RNR after a chain of Write 
P commands. When the Poll command is exe- 
cuted, the line is turned to inbound. 


Retrieves the current SCB from the communi- 
cation adapter after a line operation completes. 
The current SCB indicates which station 
responded. 
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Command 

Code 

(hex) Command Description 

23 Set Mode Transfers up to 8 bytes of setmode data to the 
communication adapter to change the status of a 
line. 

27 Enable Makes the line operational. 

29 Dial Transfers dialing data to the automatic calling unit 
(ACU). 

2F Disable Makes the line non-operational. 

E4 Sense |/O Transfers up to 7 bytes of line configuration infor- 


mation from the communication adapter. 


I/O Scheduling Overview of SDLC Lines 


During activation of an SDLC line, a station polling list (SPL) is constructed con- 
taining entries for all the physical units that are defined for the line. Initially, all the 
station entries are inactive. When any station has to be contacted and it is the first 
station on the line to be activated, the Autopoll channel program is started to do a 
Contact Poll. When a station sends in a nonsequenced acknowledgment (NSA), 
data polling begins. 


Depending on the coding of the XID operand in the definition statement for the 
station, VTAM will contact poll with a null XID or a SNRM. If the contact poll is a 
null XID, XID exchanges will occur to provide VTAM with additional information 
about the station. When the XID exchange is complete, VTAM will contact poll with 
a SNRM. | 


The Autopoll channel program is designed to run continuously as long as Receive 
Ready (RR) or Receive Not Ready (RNR) responses flow. The Autopoll channel 
program is interrupted when SDLC supervisor frames or information frames are 
received, when data is to be transmitted, or when certain PU services |/O has to be 
processed. In order to send the Write data, the Autopoll channel program is inter- 
rupted by changing the third CCW, which is a No-op, to a TIC CCW pointing to the 
Write PIU channel program. 


The Write buffers to be transmitted are pointed to by a pending queue 
(PUTPENDQ), or an error hold queue (PUTEHOLD) in the PUT entry. The SDLC 
station scheduler scans every PUT entry, starting from the current entry indicated in 
HALCUSCEB, and passes the Write buffers to TSC’s SDLC channel program build 
routine. 


If there is no Write data to be sent to any station, the Autopoll is restarted. The 
communication adapter begins polling from the next station in the station polling list 
unless the polling index is changed by the Set Mode CCW. One pass of the 
Autopoll channel program is restarted if a Read Error CCW occurs on one of the 
stations. This is accomplished by changing the TIC CCW after the Autopoll CCW 
to a No-op. | 
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/O Scheduling for PU Services 
All PU services requests are processed by the SDLC connection-manager out- 
bound on the PU services PAB in the HALCB (NCBPUPAB). Before initiating I/O 
for PU services, a switch is set to wait for current I/O (including the Autopoll 
channel program) to finish. This is done by setting the state of PU services I/O 
(HALPUSIO) to pending, which signals the channel end not to restart application 
program I/O or Autopoll after the completion of the current I/O. The continuous 
Autopoll channel program is broken by changing the third CCW, which is a No-op, 
to a TIC CCW pointing to another No-op. 


When the current I/O has been completed, the state of PU services I/O is set to 
“halted.” When the connection manager processes the request and schedules I/O, 
the state of PU services I/O changes to “active.” The state changes to “inactive” 
after the completion of I/O. 


The connection manager builds its channel program in a buffer (at TSCPCCW). 


/O Scheduling for the Link Level 2 Test 
A TESTMODE request is initiated and completed by the SDLC connection-manager 
outbound routine on the PU services PAB in the HALCB (NCBPUPAB). The link 
level 2 test is executed by the channel end appendage and the link scheduler. 


If the TESTMODE request is to start a link level 2 test, the SDLC connection- 
manager outbound routine sets the station to “test mode,” initializes fields in the 
PUT entry, obtains storage for the write and Read buffers, moves the specified data 
into the Write buffer, and starts the Write Test channel program. The Write Test 

_ channel program is repeated the specified number of times, or until the test is can- 
celed by the operator. 


If the TESTMODE request is to cancel a current test, a RECTR request is built and 
sent to network operator services so that the operator message with the test results 
can be built. 


Channel Programs 
The following channel programs are used in I/O sequences that send data to or 
receive data from devices on nonswitched and switched SDLC lines. 


Note: The Autopoll channel program (a part of the Write PIU channel program) 
and the Sense SCB channel program are in the HALCB (HALCHPGM). The other 
channel programs are formatted in I/O buffers. 


Autopoll Channel Program 
The Autopoll channel program is used to solicit data from active stations (data poll) 
and to check whether inactive stations are ready to be activated (contact poll). 
When the Autopoill CCW is executed, the communication adapter steps through the 
SDLC polling list table (SPL table; SCB table to the communication adapter) and 
sends either a data poll or a contact poll until one of the following occurs: 


e An active station responds with data. 
e An inactive station responds with a nonsequenced acknowledgment (NSA). 


e An error occurs. 
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e VTAM changes the TIC address to point to a Write PIU channel program or to 
a No-op CCW to stop the Autopoll channel program. 


If all responses to the polls are negative, the final TIC chains to the second CCW 
(the No-op) to start another polling pass through the SPL table. 


Command 
Code 
CCW (hex) Flags Description Remarks 
Set Mode 23 CC,SLI Sets the desired operating Optional 
mode. 
No-Op 03 CC,SLI Required as the last ina 
chain. 
TIC 08 — When polling, transfers 


control to the Autopoll CCW 
immediately following the 
TIC. For a Write channel 
program, either transfers to 
a string of Write PiUs or to 
a No-Op CCW to stop 
Autopoll. (See the Write 
PIU channel program.) 


Autopoll 09 CC,SLI Starts polling, points to the 
SPL table, sends Receive 
Ready (RR) for data poll or 
Set Normal Response 
Mode (SNRM) for contact 
poll depending upon the 
flag settings in the SPL. 


TIC 08 — Transfers back to the 
second command (No-Op) 
to continue polling, is 
changed to No-Op if contin- 
uous Autopoll is not 
required (for example, when 
an error occurs on a Read 
CCW), and transfers to a 
Write Test channel program 
when LL2 test is required. 


TIC 08 — Is executed when status 
modified is given to the 
channel by the communi- 
cation adapter and transfers 
to Read PIU or Sense SCB 
channel program. 


Read PIU Channel Program 
The Read PIU channel program reads data sent to VTAM by another SDLC station. 
Normally, the channel program is started when an Autopoll TIC points to the first 
Read PIU buffer. The Read PIU CCWs are built in the buffers that will receive the 
data and are chained together by TICs. The number of buffers in the chain is 
' determined by the values for the INBFRS operand of the line’s definition statement. 
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SDLC Communication Adapter Line 


When VTAM is a secondary link station or when the line is in an inbound direction, 
the communication adapter starts the Read PIU channel program with the Control 
SCB CCW that is located in the HALCB. 


When the transmission is complete or when the communication adapter detects 
error information, the communication adapter skips over any remaining Read PIU 
CCWs to a Sense CCW by which it can report error information. 


The Read PIU channel program is pointed to by the Autopoll channel program 
unless it starts with a Control SCB CCW. 


CCW 
Control SCB 


TIC 


Read PIU 
TIC 
Read PIU 


TIC 


Write PIU Channel Program 


Command 
Code 
(hex) 


0B 


08 


06 


08 


06 


08 


Flags 
CC,SLI 


CC,SLI 


CC,SLI 


Description 


Used only when 
VTAM is a secondary 
link station, the line is 
in an inbound direc- 
tion, and the Autopoll 
channel program is 
not used to point to 
the first Read CCW in 
the HALCB. 


Points to the first 
Read PIU in the 
HALCB. 


Points to the input 
area. 


Points to the next 
Read PIU CCW. 


Points to the input 
area. 


Points to the Sense 
SCB CCW that is in 
the HALCB. 


Remarks 


Optional 


Optional 


The Write PIU channel program sends data to another SDLC station. Normally, the 
channel program is started when an Autopoll TIC points to the first Write PIU 
buffer. The Write PIU CCWs are built in the buffers that contain the outbound data. 
After the data in the last buffer is sent to the station, the program executes a Poll 

CCW that sends RR (Receive Ready) so that the station may acknowledge receipt 
of the data and, optionally, may send any waiting data. The final TIC points to the 
Read PIU channel program in order to receive possible inbound data and to verify 
that the outbound data was received. 


The Write PIU channel program is pointed to by the Autopoll channel program in 


the HALCB. 
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Command 
Code 

CCW (hex) Flags Description 

Control SCB OB CC,SLI Points to an SPL entry. 

TIC 08 — Points to the first Write PIU in the 
HALCB. 

Write PIU 05 * CC Points to the buffer containing the PIU 
to be sent. Even when the data spans 
more than one buffer, the CCWs are 
command chained. 

TIC 08 — Points to a Write PIU CCW if there are 
more PIUs, or points to a Poll CCW if 
the last PIU has been sent. 

Poll OF CC,SLI Starts polling at the next entry in the 
SPL. 

TIC 08 — Points to a Read PIU or Sense SCB 
CCW. 


Write Test Channel Program 


The Write Test channel program sends and receives test frames. 


It is used when a 


link level 2 test is requested. The Write Test channel program is pointed to by the 
Autopoll channel program or by NCBCAW in the HALCB. 


CCW 
Write 
Read 


Sense SCB Channel Program 


Command 

Code 

(hex) Flags Description 

01 CC,SLI Points to data in the Write buffer. 
02 SLI Points to the Read buffer. 


The Sense SCB channel program is used to retrieve completion status from the 
communication adapter. The Sense SCB CCW is the last CCW in the chain for 
channel programs that perform normal data transfer for the Autopoll channel 
program, the Read PIU channel program, or the Write SDLC Control channel 


program. 


CCW 
Sense SCB 


sense I/O Channel Program 


Command 

Code 

(hex) Flags Description 

14 SLI Points to an input area (HALCUSCB). 


The Sense I/O channel program requests and receives line configuration informa- 
tion from the communication adapter. This information is used to verify information 
in the line’s definition statement. The verified information is included in the out- 
bound record for the line. For this channel program, the HALLFSM field of the 
HALCEB is set to X'01'. 
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Command 

Code 
CCW (hex) Flags 
Sense I/O E4 — 


Enable Line Channel Program 


Description 


Points to an input area used to obtain 
the line configuration. 


The Enable Line channel program is used when a nonswitched line is activated. 
When this channel program is being executed, the HALLFSM field in the HALCB is 


set to hex 02. 


Command 

Code 
CCW (hex) Flags 
Disable 2F CC,SLI 
Set Mode 23 CC,SLI 
Enable 27 SLI 


Answer Channel Program 


Description 


Sets the line to disable state and clears 
certain pending status conditions. 


Tells the communication adapter how 
VTAM expects to use the line and sets 
operating values such as timeout values 
and control indexes. Desired operating 
mode values are contained in the 
HALSMODE field in the HALCB. 


Causes the communication adapter to 
make the DCE interface ready. For 
CCITT V.24 or EIA RS-232C, Enable 
means activating the Data Terminal 
Ready (DTR) line and verifying that the 
response is Data Set Ready (DSR). 


The Answer channel program is used when a switched line is activated. When a 
call is received, VTAM checks information in the XID response against values in the 
corresponding switched line’s definition statement. Based on that information, 
VTAM either accepts or rejects the call. For this channel program, the HALLFSM 


field in the HALCB is set to X'01'. 
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CCW 
Disable 


Set Mode 


Enable 


Write 


Read 


Dial Channel Program 


Command 
Code 
(hex) 


2F 


23 


27 


01 


02 


Flags 
CC,SLI 


CC,SLI 


CC,SLI 


CC,SLI 


SLI 
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Description 


Sets the line to disable state, clears 
certain pending status conditions, and 
breaks any outstanding switched con- 
nections. | 


Tells the communication adapter how 
VTAM expects to use the line and sets 
operating values such as control 
indices. The desired operating mode is 
contained in the HALSMODE field in 
the HALCB. 


Causes the communication adapter to 
make the DCE interface ready. This 
CCW is not completed until an incoming 
call is accepted, so it may be active for 
a long time before it completes with the 
Data Terminal Ready (DTR) sequence. 


Points to the area containing all station 
identifiers and XID commands 
(TSCODATA). 


Points to an input area (TSCIDATA). 


The Dial channel program is identical to the Answer channel program except that a 
Dial CCW is used to initiate an outbound call (an Enable CCW is used to receive 
an inbound call). Execution of the Dial CCW transfers the desired telephone 
number to the communication adapter which forwards the number, one digit at a 
time, to an autocall adapter. The HALLFSM field in the HALCB is set to hex 02 
when this program is active. 


For X.21 switched lines, the Listen CCW follows the Dial CCW and is used by 
the communication adapter to pass call progress signals (CPS) or other 
DCE-provided information to VTAM. VTAM supports only CPS and ignores any 
other DCE-provided information received with the Listen CCW. 
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Command 
Code 
CCW (hex) Flags Description 
Disable 2F CC,SLI Sets the line to disabled state. 
Set Mode 23 CC,SLI Sets the desired operating mode as 
specified in HALSMODE. 
Dial 29 CC,SLI Points to an area (TSCPDATA) con- 
taining the digits to be dialed. 
Listen (X.21 only) OA CC,SLI Points to an area to receive CPS or 
DCE-provided information. 
Write 01 CC,SLI Points to the area containing all station 
identifiers and XID commands 
(TSCODATA). 


Read 02 SLI Points to an input area (TSCIDATA). 


Write SDLC Control Channel Program 


The Write SDLC Control channel program is used when VTAM is the secondary 
station (for example, in a VTAM-NCP connection). This channel program sends a 
nonsequenced acknowledgment (NSA) in response to a Set Normal Response 
Mode (SNRM) from a Contact Poll or in response to a Discontact (DISC) sent 
during shutdown processing. 


Command 

Code 
CCW (hex) Flags Description 
Set Mode 23 CC,SLI Sets the desired operating mode. 
Write 01 CC,SLI Points to an output area (TSCODATA) 


and will be changed to a No-Op CCW 
when closedown recording is required 
for the physical unit. 


TIC 08 — Transfers to the Sense SCB CCW that 
is in the HALCB, causing the communi- 
cation adapter to wait for some trans- 
mission from the primary station. 


Read SDLC Control Channel Program 


Like the Write SDLC Control channel program, the Read SDLC Control channel 
program is used when VTAM is the secondary station. It waits for the Set Normal 
Response Mode (SNRM) sent by the primary station on a Contact Poll. 


‘The Read SDLC control program can be pointed to by the Enable Line channel 
program. 
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Command 
Code 
CCW (hex) Flags Description 
Set Mode 23 CC,SLI Sets the desired operating mode in the 
HALSMODE field in the HALCB. It can 
be a Write CCW or No-Op CCW, if 
required. 
Read 02 — Reads an SDLC command. 


Disable Line Channel Program 


The Disable Line channel program sends a Disable CCW to shutdown the modem 
interface of the communication adapter. 


Command 
Code 
CCW (hex) Flags Description 
Disable 2F SLI Sets the line to disabled state. 


Primary XID Channel Program 


The Primary XID channel program is for a communication-adapter-attached type 5 
physical unit (XID exchange). | 


Command Contents 
Code of Address 
CCW (hex) Flags Description Field 
Set Mode 23 CC,SLI Changes the timeout value. HALSMODE 
Write 01 CC,SLI Transfers the XID(00) from Output Area 


this host to the communi- 
cation adapter attached 
host. 


Read 02 SLI Reads an SDLC command. Input Area 


Secondary XID Channel Program 


The Secondary XID channel program is for a communication-adapter-attached type 
4 physical unit (XID exchange). 
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Command Contents 
Code of Address 
CCW (hex) Flags Description Field 
Disable 2F CC,SLI Makes sure that the line — 
for non- direction is outbound. 
switched lines 
only 
Set Mode 23 CC,SLI Changes the timeout value. HALSMODE 
Enable 27 CC,SLI Causes the communication 
adapter to make the DCE 
interface ready. For CCITT 
v.24 or EIA RS-232C, 
Enable means activating 
the Data Terminal Ready 
(DTR) line and verifying 
that the response is Data 
Set Ready (DSR). 
Read 02 SLI Reads an SDLC command. Input Area 


Link, Connection, and Physical Unit Finite State Machines (MVS) (VM) 


If an error occurs during the activation or deactivation of the SDLC link or of a 
physical unit, the finite state machines can be used to determine the state of the 
link or station. 


Link State Machine Values 
OO Reset 

01 Sense I/O pending 

02 Enable pending 

08 Active 

10 Halt I/O pending 

20 DACTLINK disable pending 
30 INOP disable pending 

40 ACTLINK disable pending 


Connection State Machine Values 
0O Reset 

01 Answer pending 

02 Auto dial pending 

03  X.21 answer pending 

04 Manual dial pending 

05 X.21 autocall pending 

O06 X.21 SHM HALT I/O pending 1 
07 X.21 SHM HALT I/O pending 2 
08 Connected 

10 Abandon connection 1 

11. Abandon connection 2 

12 X.21 SHM autocall pending 1 
13 X.21 SHM autocall pending 2 
14  Pre-negotiation XID pending 

15 Send CV22 pending 

21 DACTCONNIN pending 
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41 Abandon connect out pending 

51 X.21 OBR pending 

60 Answer pending for sub-area dial start 
61 Answer pending for sub-area dial finish 
65 Autodial pending for sub-area dial links 
69 Disconnect/re-enable answer state 


Physical Unit State Machine Values 

00 Reset 

01 Contact pending 

03 Pending Discontact pending 

04 XID pending 

08 XID(00) pending 

09 Negotiation preceding as primary 

10 Active 

11. Test mode 

12 Link role negotiation proceeding 

13 Primary non-activation XID pending 

14 Primary non-activation Contact pending 

15 Primary non-activation CONTACTED (0B) pending 

21 Request Discontact (RQD) received 

22 Discontact pending 

23 Pending reset 

30 Negotiation proceeding as secondary 

31 Secondary Contact pending 

32 Secondary Set Normal Response Mode (SNRM) received 

39 Primary/secondary contention 

40 Secondary active 

41 Secondary non-activation contact pending 

42 Secondary non-activation CONTACTED (0B) pending 
_ 51 Secondary Discontact pending 

52 XID error proceeding 

56 OBR pending INOP 

58 OBR pending Contacted 

60 OBR pending Discontact 


Hints for Common Errors: Finite States (VM) (VSE) 


If an error occurs, the finite state in the PUT (PUTFSM) and in the HALCB 
(HALFSM) should be checked to find the state at which the error occurred. The 
finite state machine diagrams below show the actions occurring as a result of 
various inputs for the finite state machine values. 


The SCX in HALCB (HALCUSCB) contains the status for the last physical unit for 
which I/O was active. 


The sense field in HALCB (NCBSENSE) contains the sense data as a result of a 
unit check on the line. 


The state of PU services I/O (HALPUSIO) indicates whether or not the connection 
manager was doing I/O. 


The NCBPOLL flag, if on, indicates that the line is polling. If off, it indicates that 
either Write I/O or connection manager I/O is in progress. 
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The NCBREADY flag, if on, indicates that the link is active. 
NCBLINOP indicates a permanent link error. 


NCBSINOP indicates a permanent station error. 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Appendix D. Channel Programs 923 


SDLC Communication Adapter Line “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


924 VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” 


Network Flows 


Licensed Materials — Property of IBM 


Appendix E. Network Flows 


This appendix describes flows of the VTAM program RUs and AMRUs between 
network addressable units in single and multiple VTAM networks. Use these flows 
as guidelines to help analyze and isolate network problems caused by unexpected 
network events, such as protocol violations. The flow diagrams are divided into the 
following categories: 


e “Generic BIND (GBIND) AMRUs’” on page 930 


“Resource Activation Flows” on page 933 
“Session Establishment Flows” on page 949 
“Deactivation and Session Termination Flows” on page 976 


“Error Detection and Recovery and SSCP Management Services” on 
page 1000. 


“Dial and Answer for X.21 Switched Lines (VSE)” on page 1011. 


For certain session establishment RUs (ACTCDRM, ACTPU, ACTLU, and BIND), 
additional RUs can flow if the explicit route (ER) or virtual route (VR) selected for a 
session is not yet active. Because this flow is essentially the same for all four RUs, 
these RUs are referred to as generic bind (GBIND) AMRUs. To avoid repetition, 
the flows for these AMRUs are shown once at the beginning of this appendix. 
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Table 64 lists all the network flows illustrated here. 


Table 64 (Page 1 of 4). Index of Network Flows 


GBIND AMRU Fiow Page 

ACTLU: Sending an ACTLU request for a logical unit (LU) Figure 98 on page 931 
ACTPU: Sending an ACTPU request for a comunication controller Figure 99 on page 931 
or physical unit (PU) 

BIND: Sending a BIND request to a secondary logical unit (SLU) Figure 100 on page 932 
Virtual and explicit route: Activating a virtual route (VR) and the Figure 101 on page 932 
associated explicit route (ER) 

Resource Activation Flow Page 

Activating a CDRM 

CDRM with COLD response, activating Figure 116 on page 944 
CDRM with ERP response, activating Figure 115 on page 944 
CDRM with a virtual route-based transmission group, activating Figure 117 on page 945 


Activating a cross-network SSCP-SSCP session 


Back-to-back gateway NCPs request sessions Figure 118 on page 946 
Gateway VTAM requests session Figure 119 on page 947 
Non-gateway VTAM requests session Figure 120 on page 948 
Activating an NCP major node 

Channel-attached communication controller, activating Figure 102 on page 934 
Link-attached communication controller, activating Figure 103 on page 935 


Activating resources controlled by a host or NCP major node 


Link: Activating a link Figure 104 on page 935 
Link station: Activating a cross-subarea link station Figure 106 on page 936 
Logical unit (LU): Activating a logical unit Figure 113 on page 942 
Application program: Activating an application program and proc- Figure 114 on page 943 
essing an OPEN ACB request : 

Physical unit (PU): Activating a physical unit type 2.0 Figure 108 on page 938 
Physical unit (PU): Activating a physical unit type 2.0 with load Figure 109 on page 939 
required 
Physical unit (PU): Moving a dynamically added physical unit Figure 111 on page 941 
Physical unit (PU): Moving a SYSGENed physical unit Figure 110 on page 940 
SSCP takeover of peripheral node logical units (LUs) Figure 112 on page 942 
Switched connection, establishing Figure 107 on page 937 
Switched link with takeover, activating Figure 105 on page 936 
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Table 64 (Page 2 of 4). Index of Network Flows 


Session Establishment Flow Page 


Failed session establishment 


Failure (CDINIT rejection) of session initiation by a secondary Figure 145 on page 973 
logical unit (SLU) for single gateway VTAM and single gateway 

NCP 

Failure (CINIT rejection) of setup procedure initiated by a sec- Figure 147 on page 975 
ondary logical unit (SLU) for single gateway VTAM and single 

gateway NCP 

Failure (SETCV failure) of session initiation by a secondary logical Figure 146 on page 974 
unit (SLU) for single gateway VTAM and single gateway NCP 

Gateway VTAM 

Default partitioning of gateway VTAM responsibility spanning three Figure 139 on page 966 
networks 

Multiple gateway VTAMs and back-to-back gateway NCPs Figure 122 on page 952 
PLU availability for autologon, notification of Figure 144 on page 972 
Requests initiated by primary logical units (PLUs) 

Dependent PLU initiating cross-domain session with independent Figure 128 on page 957 
SLU 

Independent PLU initiating cross-domain session with independent Figure 127 on page 956 
SLU 

independent PLU requesting session with independent SLU Figure 130 on page 959 
through a single gateway VTAM and single gateway NCP 

OPNDST ACQUIRE Figure 123 on page 953 
PLU initiating request for single gateway VTAM and single gateway Figure 129 on page 958 
NCP | 


PLU initiating request setup queued for single gateway VTAM and Figure 131 on page 960 
single gateway NCP : 


SIMLOGON Figure 124 on page 953 
SIMLOGON(RELREQ) Figure 125 on page 954 
SIMLOGON(RELREQ): Session is pending active or already in Figure 126 on page 955 
progress 


Requests initiated by secondary logical units (SLUs) 


Dependent SLU initiating cross-domain session with application Figure 136 on page 963 
logical unit (LU) 

INIT SELF Figure 134 on page 962 
LOGON Figure 132 on page 961 
Predesignated control of gateway NCP by middle host Figure 139 on page 966 
REQSESS Figure 133 on page 961 
Sending an unformatted request to the SSCP Figure 135 on page 963 
Single gateway connecting three or more networks Figure 138 on page 965 
Single gateway VTAM and single gateway NCP Figure 137 on page 964 
Requests initiated by third parties 

CLSDST PASS Figure 140 on page 968 
CLSDST PASS with NOTIFY Figure 141 on page 969 
Request spanning three networks Figure 142 on page 970 
VARY LOGON or LOGAPPL processing Figure 143 on page 971 
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Table 64 (Page 3 of 4). Index of Network Flows 


Deactivation or Session Termination Flow Page 
CLOSE ACB processing Figure 163 on page 990 
Deactivating an application program Figure 164 on page 991 


Deactivating a CDRM 


Forced Figure 167 on page 993 
Forced, without affecting active sessions Figure 169 on page 995 
Forced or immediate, VTAM releases prior to V3R4.1 Figure 170 on page 996 
immediate Figure 166 on page 993 
Immediate, without affecting active sessions Figure 168 on page 994 
Normal | Figure 165 on page 992 
Deactivating a logical unit (LU), single network 

Forced Figure 149 on page 978 
Immediate Figure 148 on page 978 
VARY NET,TERM Cleanup Figure 161 on page 988 
VARY NET,TERM Unconditional Figure 160 on page 987 
With Giveback Figure 150 on page 979 
Deactivating a logical unit (LU), multiple networks 

Independent PLU sends BFCLEANUP for independent SLU Figure 151 on page 980 
Independent PLU sends UNBIND for independent SLU Figure 152 on page 980 
PLU sends UNBIND for multiple gateway VTAMs and single Figure 153 on page 981 
gateway NCP | 

PLU sends UNBIND for single gateway VTAM and single gateway Figure 154 on page 981 
NCP | 

SLU requests TERMINATE SELF (CLEANUP) for single gateway Figure 156 on page 983 


VTAM and single gateway NCP 


SLU requests TERMINATE SELF for multiple gateway VTAMs and Figure 155 on page 982 
back-to-back gateway NCPs 


SLU requests TERMINATE SELF for single gateway VTAM and Figure 157 on page 984 
single gateway NCP 


Type 2.1 nodes, active termination Figure 158 on page 985 


Deactivating a physical unit (PU) acting as an adjacent link Figure 159 on page 986 
station for independent logical unit (LU) sessions 


Queued session, terminating Figure 162 on page 989 


Route failure 


Route failure in intermediate network causes termination of LU-LU Figure 172 on page 998 
sessions 

Route failure in intermediate network causes termination of Figure 173 on page 999 
SSCP-SSCP sessions 
SSCP-SSCP session termination causes LU-LU sessions to be Figure 171 on page 997 
broken 
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Table 64 (Page 4 of 4). Index of Network Flows 
Error and SSCP Management Services Flow Page 


Error recovery processing (ERP) 


Hard INOP Figure 175 on page 1002 
Soft INOP Figure 174 on page 1001 
LPDA-2 processing 

Unsolicited LPDA-2 test on permanent link error with two link seg- Figure 179 on page 1005 
ments 

Unsolicited LPDA-2 test on thresholds reached for an LPDA-2 Figure 177 on page 1003 
physical unit (PU) with one link segment 

Unsolicited LPDA-2 test on thresholds reached for an LPDA-2 Figure 178 on page 1004 


physical unit (PU) with two link segments 


SSCP management services processing 


FORWARD and DELIVER Routing Figure 176 on page 1003 
XRF processing 

Secondary logical unit (LU) initiate with USERVAR (LOGON) Figure 182 on page 1009 
Third-party initiate (CLSDST PASS) Figure 183 on page 1010 
XRF primary and backup sessions, establishment of Figure 180 on page 1006 
XRF session switch (takeover) Figure 181 on page 1008 
X.21 Switched Lines Flow Page 

Dial and answer for X.21 switched lines Figure 184 on page 1011 


Many abbreviations are shown at the top of the network flows. The forewing list 
gives the meaning of some of those abbreviations: 


APPL Application 

BF Boundary function 

BFSS Boundary function session services 
BNN Boundary network node 

cS Configuration services 

EU End user 

LU Logical unit 

NCP Network Control Program 

NOS ___— Network operator services 

PLU = Primary logical unit 

PN Peripheral node 

PU Physical unit 

PUNS Physical unit services 

SLU Secondary logical unit 

ss Session services 

SSCP System services control point 

TSC «Transmission subsystem component 
XRF Extended recovery facility 
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Generic BIND (GBIND) AMRUs 


Access method RUs (AMRUs) are internal requests that might appear in the PIU 
trace and are a function of Physical Unit Services (PUNS), Configuration Services, 
or Session Services. 


Figure 98 on page 931 through Figure 101 on page 932 show the flow of these 
requests and responses between the SSCP and logical and physical units when a 
virtual route (VR) or explicit route (ER) selected for a session is not yet active. 


Index of Generic BIND (GBIND) AMRU Flows 
Table 65 lists the GBIND AMRU flows illustrated here. 


Table 65. Index of Generic BIND (GBIND) AMRU Flows 
Flow Page 
ACTLU: Sending an ACTLU request for a logical unit (LU) Figure 98 on page 931 


ACTPU: Sending an ACTPU request for a communication controller Figure 99 on page 931 
or physical unit (PU) 


BIND: Sending a BIND request to a secondary logical unit (SLU) Figure 100 on page 932 


Virtual and explicit route: Activating a virtual route (VR) and the Figure 101 on page 932 
associated explicit route (ER) 
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Communication 
SSCP PUS Controller PU 


GBIND (ACTLU) 
ER_ACT 


ER_ACT_REPLY 
ACTVR 
+RESP (VRPRS) 
Isolated VRPRS 

ACTLU 


Figure 98. Sending an ACTLU Request for a Logical Unit (LU) 


Communication 
SSCP PUS Controller 


GBIND (ACTPU) 
ER ACT 


ER_ACT_REPLY 
ACTVR 

+RESP (VRPRS) 

Tsolated VRPRS 


+RESP 
CONTACT 
+RESP 
ACTPU 


ACTPU (1) 


LU 


GBIND AMRUs 


Figure 99. Sending an ACTPU Request for a Communication Controller or Physical Unit 


(PU) 


1. The ACTPU can flow either to the communication controller or to a physical 


unit. 
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GBIND AMRUs 


PUS of PUS of 
PLU PLU SLU 
GBIND (BIND) 
ER_ACT 
ER ACT REPLY 
ACTVR 
+RESP (VRPRS) 
Isolated VRPRS 


BIND 


+RESP 
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SLU 


Figure 100. Sending a BIND Request to a Secondary Logical Unit (SLU) 


Operator's Communication 
Console SSCP PUS Controller 
V NET,ACT, 
ID=PATH Deck 
Message 
ER_OP 
ER_OP 
GBIND (ACTPU) ——_—»> 


ER_ACT 
ER_ACT_REPLY 
ACTVR 
+RESP (VRPRS) 
Isolated VRPRS 
ACTPU 
+RESP 


Figure 101. Activating a Virtual Route (VR) and the Associated Explicit Route (ER) 
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Resource Activation Flows 


Figure 102 on page 934 through Figure 120 on page 948 show the flow of 
requests and responses between the SSCP and logical and physical units to acti- 
vate resources. 


For channel activation flows see Appendix D, “Channel Programs” on page 873. 


index of Resource Activation Flows 
Table 66 lists the resource activation flows that are illustrated here. 


Table 66. Index of Resource Activation Flows 


Flow Page 

Activating a CDRM 

CDRM with COLD response, activating Figure 116 on page 944 
CDRM with ERP response, activating Figure 115 on page 944 
CDRM with a virtual route-based transmission group, activating Figure 117 on page 945 


Activating a cross-network SSCP-SSCP session 


Back-to-back gateway NCPs request sessions Figure 118 on page 946 
Gateway VTAM requests session Figure 119 on page 947 
Non-gateway VTAM requests session Figure 120 on page 948 
Activating an NCP major node 

Channel-attached communication controller, activating Figure 102 on page 934 
Link-attached communication controller, activating | Figure 103 on page 935 


Activating resources controlled by a host or NCP major node 


Link: Activating a link Figure 104 on page 935 
Link station: Activating a cross-subarea link station Figure 106 on page 936 
Logical unit (LU): Activating a logical unit | Figure 113 on page 942 
Application program: Activating an application program and proc- Figure 114 on page 943 
essing an OPEN ACB request 

Physical unit (PU): Activating a physical unit type 2.0 Figure 108 on page 938 
Physical unit (PU): Activating a physical unit type 2.0 with load Figure 109 on page 939 
required 

Physical unit (PU): Moving a dynamically added physical unit Figure 111 on page 941 
Physical unit (PU): Moving a SYSGENed physical unit Figure 110 on page 940 
SSCP takeover of peripheral node logical units (LUs) Figure 112 on page 942 
Switched connection, establishing Figure 107 on page 937 
Switched link with takeover, activating Figure 105 on page 936 
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Operator's Communication 
Console SSCP PUS Controller PU LU 
V NET,ACT, 
ID=ncp name 
ADDLINK 
+RESP 
ACTLINK 
+RESP 


ADD LINKSTA 


+RESP 
CONTACT 
+RESP 
CONTACTED 
ER-OP 
ER-OP 
ACTPU 
+RESP (1) 


SDT 
+RESP 


(Routing Data for DPU) (2) 


Message (2) 
IST9291 


Load of DPU 
Complete 


SETCV 
Message 
IST@93I +RESP 
Node Active 
ACTLINK 
+RESP (ACTLINK) 
CONTACT 
+RESP (CONTACT) 


CONTACTED 


Message ACTPU 


IST4651 
Command 
Complete 
ACTLU 
+RESP(ACTLU) 
User-defined Logon Message 


Figure 102. Activating a Channel-Attached Communication Controller 


+RESP 


1. Includes NCP dynamic path definition capability indicator. 


2. Flows only for dynamic path definition. SETCV and IST929I flow for each 
dynamic path definition member specified. 
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Local Remote 
Operator's PUS in Communication Communication 
Console SSCP Host Controller Controller PU LU 
V NET,ACT, 
ID=ncp name 
ACTLINK 
+RESP 
CONTACT 
+RESP 
XID 
CONTACTED XID 
(LOADED) 
ER_OP 
ER_OP 
NC_ER_ACT 


NC_ER_ACT REPLY 


ACTVR 


Node Active 


Figure 103. Activating a Link-Attached Communication Controller 


1. Flows only for dynamic path definition. SETCV and IST929I flow for each 
dynamic path definition member specified. 


Operator's Communication 
Console SSCP Controller 


V NET, ACT, 
ID=link name 
ACTLINK 


Message 
IST993I 
Node Active 


+RESP 


Figure 104. Activating a Link (ACTLINK) 
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Resource Activation Flows 


Operator's 
Console SSCP NCP PU 
V NET,ACT 
ID=link name 
ACTLINK 
+RESP (ACTLINK) 
ACTCONNIN 
+RESP (ACTCONNIN) 
Message 
1$T7871 
SSCP takeover | REQCONT 
in progress 
SETCV 
+RESP (SETCV) 
CONTACT 
+RESP (CONTACT) 
XID 
XID 
CONTACTED 
ACTPU 


Message 
IST6211 

SSCP takeover 
complete 


+RESP (ACTPU) 
RNAA (for each LU) 
+RESP (RNAA) 
SETCV (for each LU) (1) 
+RESP (SETCV) 
ACTLU 
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LU 


Figure 105. Activating a Switched Link with Takeover 


1. SETCV does not flow for NCPs that support peripheral nodes. 


Operator's 
Console 


V NET, ACT, 
ID=RIN name 


Message 
IST093I 
Node Active 


SSCP 


Communication 
Controller 


CONTACT 


+RESP (CONT) 


CONTACTED 


Figure 106. Activating a Cross-Subarea Link Station 
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SSCP 


ACTLINK 
+RESP 

ACTCONNIN 
+RESP 


CONNOUT 


REQCONT 
(Of fhook) 


SETCV 
+RESP 
CONTACT 
+RESP 
CONTACTED 
ACTPU 


SETCV 
(for each LU) 


Communication Physical 
Controller Unit 


Incoming cal] 
XID 
XID RESP 


+RESP 


User-defined Logon Message Hage 


Figure 107. Establishing a Switched Connection 


Resource Activation Flows 


Logical 
Unit 


+RESP 


To establish a switched connection, the SSCP sends an Activate Link request to 

indicate that the link is active. An Activate Connect In request is sent to enable the 
communication controller to answer incoming calls. (Instead of Activate Connect In, 
Dial could be sent to initiate an outbound call.) When a call comes in, the commu- 


nication controller sends an exchange identification (XID) and the physical unit 
responds with its ID (station address). The communication controller sends a 


Request Contact (Offhook) request to the SSCP. The SSCP sends a Set Control 


Vector request containing address and pacing information to the communication 


controller. The standard activation sequence then occurs. 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


Appendix E. Network Flows 


937 


Resource Activation Flows | “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Operator's Communication 
Console SSCP Controller PU LU 
V NET,ACT, 
ID=PU name 
CONTACT 
+RESP 
SNRM (1) 
UA 
CONTACTED 
ACTPU 


Message IST693I +RESP (2) 
Node Active 


+RESP 


Figure 108. Activating a Physical Unit Type 2.0 


1. An XID, instead of a SNRM, will flow to a switched line. 


2. Additional RUs flow if the physical unit must be loaded. These RUs are shown 
in Figure 109 on page 939. 
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Physical 
Unit Load 
Program SSCP PU-T2 


+RESP (ACTPU) 
Cold Load Required (1) 


or NS_LOREQD 


Deliver (NS_INITLOAD) 


Forward (NS_IPL_INIT) NS_IPL_INIT 


Forward (NS_IPL_TEXT) NS_IPL_TEXT 


° (2) 
e 
NS_IPL_FINAL 


e 
Forward (NS_IPL_FINAL) 


Forward (NS_LOADSTAT) 
(Load Successful) 


Figure 109. Activating a Physical Unit Type 2.0 with Load Required 


1. This figure shows only the RUs that flow when a type 2 physical unit requires 
loading. For the RUs that flow before and after those in this figure, see 
Figure 108 on page 938. 


2. NS_IPL_TEXT and the response might repeat. 


For type 2.0 physical units that require loading before they can be activated, the 
request for load is indicated in the ACTPU response. (Following activation, the 
physical unit might request loading with an NS_LDREQD RU.) 


The SSCP formats the load request into a network services (NS) RU to initiate the 
load. The management services subcomponent of the SSCP then sends the 
embedded request to the physical unit load program of the Downstream Load 
Utility. 


If the physical unit load program is not available, it sends a negative response to 
the SSCP's Deliver RU. The SSCP then sends an NS_IPL_ABORT RU to the 
physical unit for deactivation processing. (If the load was requested with an 
NS_LDREQD RU, the physical unit is not deactivated; in fact, it might try the load 
request again.) 


If the physical unit load program is available, as in Figure 109, it sends a positive 
response to the SSCP's Deliver RU. When the load program is complete, it sends 
a Forward RU, containing an NS_LOADSTAT RU, to relay the status of the load 
operation. | 
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SSCP 
Operator Configuration SSCP 
Console Services SYSDEF NCP 


VARY DRDS or 


(MOVE) 


(Sysdef moves 
RDTE of PU) 

Message 

IST670I VARY 

PROCESSING 

COMPLETE FOR 

(nodename) 


RNAA (move) (1) 
+RESP (RNAA) 
CONTACT 


Figure 110. Moving a SYSGENed Physical Unit 


1. RNAA flow is as normal. RNAA does not flow for MODIFY DR, TYPE=MOVE, 
ACT=NO. 
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SSCP 
Operator Configuration SSCP 
Console Services SYSDEF NCP 


VARY DRDS or 


(Sysdef moves 
RDTE of PU) 


Figure 111. Moving a Dynamically Added Physical Unit 


1. RNAA flow is as normal. RNAA does not flow for MODIFY DR, TYPE=MOVE, 
ACT=NO. | 
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V ACT, 
id=PU 


CONTACT 


CONTACTED 


BSSESINFO (1) 


+RESP w/session info (2) 
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Figure 112. SSCP Takeover of Peripheral Node Logical Units 


Note: The following conditions are assumed for this example: 


e The physical units being taken over are defined with ANS=CONTINUE, speci- 
fying that any LU-LU sessions that are active at SSCP-failure time will continue. 


e There are some LU-LU sessions active at failure time under the physical unit 


being taken over. 


1. Independent logical unit only (possible multiple RUs) 


2. Dependent logical unit only. 


Operator's Communication 
Console SSCP Controller PU LU 


V NET,ACT, 
ID=LU name 


ACTLU 
User-defined Logon Message 


Figure 113. Activating a Logical Unit 


Message 
IST@931 
Node Active 
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Operator's 
Console SSCP PUNS LU Services OPEN/CLOSE EU 


V NET,ACT, 
ID=APPL name (1) 


Node Active (1) 
OPEN ACB 
OPEN ACB 
AMRU 


ADDNR AMRU 
4 ———_—_ 


+RESP 


CPWAIT (2) 


Figure 114. Activating an Application Program and Processing an OPEN ACB Request 


1. These do not flow for OPEN ACB processing. 


2. PUNS cannot send a response to the OPEN ACB request until LUS receives 
an ACTLU request for the application program. Therefore, PUNS issues 
CPWAIT and waits for LUS to post it. Once LUS has received the ACTLU, it 
posts PUNS, which then sends a response to the OPEN ACB request. 


For the close ACB flow see Figure 163 on page 990. 
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Operator's 
Console SSCP1 SSCP2 


V NET,ACT,ID=SSCP2 


ACTCDRM (ERP) 


+RESP (ERP) Terminate migration 
user sessions 


Terminate migration Seen ee 
user sessions 


Message ISTQ93I 
Node Active 
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Figure 115. Activating CDRM with ERP Response 


Operator's 
Console SSCP1 SSCP2 


V NET,ACT, ID=SSCP2 


ACTCDRM (ERP) 


Terminate all 
user sessions 


+RESP (COLD) 


Terminate 
migration 
user sessions 


Message IST093I 
Node Active 


Figure 116. Activating CDRM with COLD Response 
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Operator's 
console SSCP1 SSCP2 


V NET, ACT, 
ID=SSCP2 


ACTCDRM 
(VR-TG capable) 


+RESP (VR-TG capable) 


TDU (1) 


SDT response 


(CP-CP sessions set up) 


Figure 117. Activating a CDRM with a Virtual-Route-Based Transmission Group 


1. If the transmission group is an intermediate routing transmission group 
(NN-—NN), the topology database update (TDU) will be built and broadcast. If 
the host is a migration data host, the topology database acre (TDU) will be 
built and sent to its server. 
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Gateway Gateway NCP1 Gateway NCP2 Gateway 
Operator's SSCP1 for Network A for Network B  SSCP2 
Console Network A and Network B and Network C- Network B 
V NET,ACT, 
ID=SSCP2 


Message IST097I 
Command Accepted 


RNAA (for SSCP1 
and SSCP2) 


+RESP (address of 
SSCP1 and SSCP2) 


SETCV (address 
map, VRID lists) 


ACTCDRM (Vector) 
ACTCDRM 


REQACTCDRM 


RNAA (for SSCP1 
and SSCP2) 


+RESP (address of 
SSCP1 and SSCP2) 


SETCV (address 
map, VRID lists) 


ACTCDRM (Vector) 


ACTCDRM 
ACTCDRM 


NOTIFY (SESSST) 


NOTIFY (SESSST) 


Figure 118. Back-to-Back Gateway NCPs Request Sessions 
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Gateway Gateway NCP 
Operator's SSCP1 for Network A SSCP2 
Console Network A and Network B Network B 


V NET,ACT, 
ID=SSCP2 


Message IST697I 
Command Accepted 


RNAA (for gateway, 
SSCP1 and SSCP2) 


+RESP (address of 
gateway VTAM1 and 
SSCP2) 


SETCV (address map, 
VRID lists) 


ACTCDRM 
(gateway vector) 


ACTCORM 
(gateway vector) 


NOTIFY (SESSST) 


Message IST093I 
Node Active 


Figure 119. Gateway VTAM Requests Session 
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Gateway NCP 
Operator's SSCP2 for Network A 
Console Network 8B and Network B 


V NET,ACT, ID=SSCP1 


Message IST0971 
Command Accepted 


Gateway 
SSCP1 
Network A 


Message IST4751 
Procedure Failed 


Figure 120. Non-Gateway VTAM Requests Session 
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Session Establishment Flows 
Figure 121 on page 951 through Figure 147 on page 975 show the flow of 


requests and responses to establish single network and cross-network LU-LU ses- 


sions. 


Index of Session Establishment Flows 
Table 67 lists the session establishment flows that are illustrated here. 


Table 67 (Page 1 of 2). Index of Session Establishment Flows 
Flow Page 


Failed session establishment 


Failure (CDINIT rejection) of session initiation by a secondary Figure 145 on page 973 
logical unit (SLU) for single gateway VTAM and single gateway 

NCP 

Failure (CINIT rejection) of setup procedure initiated by a sec- Figure 147 on page 975 


ondary logical unit (SLU) for single gateway VTAM and single 
gateway NCP 


Failure (SETCV failure) of session initiation by a secondary logical Figure 146 on page 974 
unit (SLU) for single gateway VTAM and single gateway NCP 

Gateway VTAM 

Default partitioning of gateway VTAM responsibility spanning three Figure 139 on page 966 
networks | 

Multiple gateway VTAMs and back-to-back gateway NCPs Figure 122 on page 952 
PLU availability for autologon, notification of Figure 144 on page 972 
Requests initiated by primary logical units (PLUs) 

Dependent PLU initiating cross-domain session with independent Figure 128 on page 957 
SLU 

Independent PLU initiating cross-domain session with independent Figure 127 on page 956 
SLU 

Independent PLU requesting session with independent SLU Figure 130 on page 959 
through a single gateway VTAM and single gateway NCP 

OPNDST ACQUIRE Figure 123 on page 953 
PLU initiating request for single gateway VTAM and single gateway Figure 129 on page 958 
NCP 


PLU initiating request setup queued for single gateway VTAM and Figure 131 on page 960 
single gateway NCP 


SIMLOGON Figure 124 on page 953 


SIMLOGON(RELREQ) Figure 125 on page 954 
SIMLOGON(RELREQ): Session is pending active or already in Figure 126 on page 955 
progress 

Requests initiated by secondary logical units (SLUs) 

Dependent SLU initiating cross-domain session with application Figure 136 on page 963 
logical unit (LU) 

INIT SELF Figure 134 on page 962 
LOGON Figure 132 on page 961 
Predesignated control of gateway NCP by middle host Figure 139 on page 966 
REQSESS Figure 133 on page 961 
Sending an unformatted request to the SSCP Figure 135 on page 963 
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Table 67 (Page 2 of 2). Index of Session Establishment Flows 


Flow Page 

Single gateway connecting three or more networks Figure 138 on page 965 
Single gateway VTAM and single gateway NCP Figure 137 on page 964 
Requests initiated by third parties 

CLSDST PASS Figure 140 on page 968 
CLSDST PASS with NOTIFY Figure 141 on page 969 
Request spanning three networks Figure 142 on page 970 
VARY LOGON or LOGAPPL processing Figure 143 on page 971 
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Gateway Gateway 
Gateway NCP1 for Gateway NCP2 for Gateway 
SSCP1 Network A and SSCP2 Network C and SSCP3 
SSCP1 Network A Network C Network C Network B Network B 


CDINIT 
(DLUX, LU1) (1) CDINIT 
(LU3, LU1) 


CDINIT 
(LU3, LU1) 


CDINIT 
(LU3, LU1) 


CDINIT 
(LU3, LU1) 


SETCV 
(address 


+RESP 
(CDINIT, 

address of 
LU3) 


SETCV 
(address map) 


SETCV (names, 
VR list) 


+RESP (CDINIT, 


COCINIT 
COCINIT 


COCINIT 


CDCINIT 


COCINIT 


+RESP (2) 


Figure 121. Default Partitioning of Gateway VTAM Responsibility Spanning Three Networks 


1. Only the SSCP-SSCP session communication is shown. Assume LU1 (a 
logical unit owned by SSCP1 in Network A) requests a session with DLUX (an 
alias for LU3 in Network B; LU3 is a logical unit owned by gateway VTAMS). 
LU1 is the SLU in the request session. 


2. Session setup proceeds as shown in the basic flows. BIND flows from LU3 to 
gateway NCP2, to gateway NCP1, and to LU1. 
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Gateway Gateway NCP1 Gateway NCP2 Gateway 


SSCP1 for Network A for Network C SSCP2 

LU1 SSCP1 Network A and Network C and Network B- Network LU2 
INIT_SELF 
(DLUX) CDINIT 
——_——+| (DLUX, LU1) 

RNAA 

+RESP 

CDINIT 


(LU2, OLUX) CDINIT 
(LU2, OLUX)) CDINIT 
(LU2, OLUX) 


RNAA 
+RESP 


SETCV 
(address map, 
names, VR 
list) 


+RESP 


+RESP CDINIT 
+RESP CDINIT| (address of 
+RESP CDINIT | (address of | LU2) 
(address of {LU2) 
LU2) 


SETCV 
(address map, 
names, VR 
list) 


+RESP CDINIT +RESP 
(address of 
+RESP DLUX) 


(INIT) 
COCINIT 
CDCINIT 
COCINIT 
CDOCINIT 
+RESP 
+RESP 
CINIT 
+RESP 
+RESP 
+RESP BIND 
BIND (LU2, OLUX) 
BIND (DLUX, LU) 
(DLUX, LU) 
+RESP 
(DLUX, LU) +RESP 
(LU2, OLUX) 
NOTIFY 
+RESP 
NOTIFY 
SESSST 
CDSESSST 
CDSESSST 
CDSESSST 
CDSESSST 
+RESP 
+RESP 
+RESP 
+RESP 


Figure 122. Multiple Gateway VTAMs and Back-to-Back Gateway NCPs 
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EU PLU SSCP of PLU SSCP of SLU SLU EU 


OPNDST ACQUIRE 


INITIATE 
CDINIT 
+RESP 
+RESP 
COCINIT 
CINIT 
+RESP 
+RESP | —————_———» 
BIND 
SCIP EXIT 
+ 
+RESP 


SESSST SESSST 


CDSESSST 


SCIP EXIT 


Figure 123. Primary Logical Unit Initiate (OPNDST ACQUIRE) 


EU PLU SSCP of PLU SSCP of SLU SLU EU 
BIND 
SIMLOGON 
INITIATE 
CDINIT 
+RESP 
+RESP 
CDCINIT 
CINIT 
LOGON EXIT (1) 
+RESP 
OPNDST ACCEPT (1) 
+RESP 
BIND 
SCIP EXIT 
OPNSEC 


SESSST SESSST 


SCIP EXIT 


Figure 124. Primary Logical Unit Initiate (SIMLOGON) 


1. LOGON EXIT and OPNDST ACCEPT flow only when the PLU is associated 
with an application program. It does not appear in the flow if the PLU isa 
device-type logical unit. This is true for many following flows with LOGON EXIT 
and OPNDST ACCEPT. 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 Appendix E. Network Flows 953 


Session Establishment Flows “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


SSCP of SSCP of SSCP of 
Eul PLUI PLU1 SLU SLU EU3 PLU2 PLU2 EU2 


SIMLOGON 
INITIATE 


CDINIT 
+RESP 
+RESP 
+RESP 
COCINIT 
CINIT 
LOGON EXIT +RESP 
OPNDST 
ACCEPT 
+RESP 
BIND 
SCIP EXIT 
OPNSEC 
+RESP 


SESSST SESSST 


COSESSST 


SCIP EXIT 


SIMLOGON 
RELREQ 
INITIATE 
CDINIT 
+RESP (queued) 
+RESP (queued) 
+RESP (queued) 


NOTIFY 
RELREQ 
EXIT 

~~~ 


NOTIFY 


Figure 125. Primary Logical Unit Initiate (SIMLOGON(RELREQ)) 


* 
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SSCP of SSCP of 
EU1 PLUI PLUL SLU SLU 


SIMLOGON 


INITIATE 
CDINIT 


OPNDST 
ACCEPT 


NOTIFY (1) 


NOTIFY (1) 
RELREQ EXIT (1) 


EU3 


EXIT 
OPNSEC 


SCIP EXIT 


SSCP of 
PLU2 PLU2 EU2 


SIMLOGON 
RELREQ 
INITIATE 
CDINIT 
+RESP (queued) 
NOTIFY (1) +RESP (queued) 
NOTIFY (1) 
RELREQ 
EXIT +RESP (queued) 


Session Establishment Flows 


Figure 126. Primary Logical Unit Initiate (SIMLOGON(RELREQ)): Session Is Pending Active 


or Already in Progress 


1. If the session is pending active, the NOTIFY request and the RELREQ EXIT 
request flow after the response to the CDINIT request from PLU2's SSCP. If 
the session is already in progress, these requests flow after the response to the 


OPNDST ACCEPT. 
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BIND 
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Figure 127. Independent PLU Initiating Cross-Domain Session with Independent SLU 


1. RNAA flows only if the network address is needed. 
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NCP 
PLU SSCP1 SSCP2 BF2 PN 
INIT 
CDINIT 
RNAA (1) 
+RESP 
+RESP 
CDINIT 
CINIT 
+RESP 
+RESP 
VR 
PROTOCOLS 
BIND 
SESSST BFSESSST 
CDSESSST 
+RESP 


SLU 


Session Establishment Flows 


Figure 128. Dependent PLU Initiating Cross-Domain Session with Independent SLU 


1. RNAA flows only if the network address is needed. 
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& 


Gateway NCP 
LU3 Gateway for Network A . 
(PLU) SSCP1 SSCP1 and Network B SSCP2 


INIT OTHER 
(LUu2) 


CDINIT 
(LU2, LU3) 


COINIT 
(LU2, LU3) 


CDINIT 
(LU2, LU3) 


+RESP (address 
+RESP (address of jof LU2, $3276) 
LU2, $3276) 


COCINIT 


SETCV (address 
map,names,VR list) 


CDCINIT 


+RESP CDINIT 
(address of LU2) 


+RESP (SETCV) 


+RESP (INIT) 


CDOCINIT 
+RESP (CDCINIT) 


+RESP (CDCINIT) 
(COCINIT) 


(See Note) 


Figure 129. PLU-Initiated Request for Single Gateway VTAM and Single Gateway NCP 


hus val 


Note: Session setup continues as in the flow for a SLU-initiated session. 
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LU1 BF 


GATEWAY GATEWAY BF 
(PLU) (PLU) SSCP1 SSCP NCP SSCP2 (SLU) SLU 
BIND 
BFINIT 
RNAA (1) 
+RESP 
(RNAA) 
CDINIT 
RNAA 
+RESP 
(RNAA) 
CDINIT 
RNAA (1) 
+RESP 
+RESP (RNAA) 
(CDINIT) 
+RESP 
(CDINIT) 
CDCINIT 
BFCINIT 


+RESP 
+RESP (CDCINIT) 
(BFCINIT) 

VR 


VR PROTOCOLS 
BIND 
BIND 
+RESP 
(BIND) 


BFSESSST NOTIFY 
CDSESSST 
+RESP 
(CDSESSST) 


BFSESSST 


Session Establishment Flows 


Figure 130. Independent PLU Requesting Session with Independent SLU through Single 


Gateway VTAM and Single Gateway NCP 


1. RNAA flows only if the network address is needed. 
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i Gateway NCP 
LU3 Gateway for Network A LU2 
(PLU) SSCP1 SSCP1 and Network B SSCP2 (SLU) 


INIT_OTHER 
(Lu2) 


CDINIT 
(LU2, LU3) 


CDINIT 
(LU2, LU3) | CDINIT 


(LU2, LU3) 


+RESP 
(address of 
LU2, queued) 


+RESP 
(address of 
LU2, queued) 


SESSEND 
+RESP CDINIT| SETCV 


CDINIT (DQ) 


CDINIT (DQ) 


+RESP (INIT) ( 
SETCV) 


CDINIT (DQ) 


SETCV 
(VR list) 


+RESP 
(SETCV) 


CDCINIT 


CDCINIT 


COCINIT 


+ 


+RESP 
(CDCINIT) 


(CDCINIT) (1) 


Figure 131. PLU-Initiated Request Setup Queued for Single Gateway NCP and Single 
Gateway VTAM 


1. Session setup continues as in the flow for an SLU-initiated session. 
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SSCP of SSCP of 
EU PLU PLU SLU SLU EU 


“LOGON” 


CDINIT 


+RESP 


“LOGON SUCCESSFUL” 


CDOCINIT 


+RESP 


LOGON EXIT 
+RESP 


OPNDST 
ACCEPT 
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Figure 132. Secondary Logical Unit Initiate (LOGON) 


SSCP of SSCP of 
EU PLU PLU SLU SLU EU 
REQSESS 
INITIATE 
CDINIT 
+RESP 
+RESP 
CDCINIT 
CINIT 
LOGON EXIT +RESP 
OPNDST 
ACCEPT 
+RESP 
BIND 


SCIP EXIT 


OPNSEC 


SESSST SESSST 


CDSESSST 


SCIP EXIT 


Figure 133. Secondary Logical Unit Initiate (REQSESS) 
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SSCP of 


SSCP of 
EU PLU PLU SLU SLU EU 
(End User Initiate) 
INIT_SELF 
CDINIT 
+RESP 
+RESP 
(End User) 
CDCINIT 
CINIT 
LOGON EXIT +RESP 
OPNDST 
ACCEPT 
+RESP 
BIND 
SESSST SESSST 


CDSESSST 


Figure 134. Secondary Logical Unit Initiate (INIT SELF) 
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SSCP Request Unformatted Logical 
Processor System Services Unit 


Character-Coded 
Logon or Logoff 
Initiate or Terminate 


Character-Coded 


Message 


Figure 135. Sending an Unformatted Request to the SSCP 


In this example, the logical unit sends a character-coded logon or logoff to the 
SSCP. The unformatted system services portion of SSCP converts the logon into a 
field-formatted Initiate Self or Terminate Self request. The request is then passed 
to the SSCP request processor. 


If the return code indicates an unsuccessful transmission, the unformatted system 
services portion of SSCP converts the request into a form that can be understood 
by the terminal logical unit. 


NCP 
APPL SSCP1 SSCP2 BF2 SLU 


INIT_SELF 
CDINIT 


+RESP 


CDCINIT 
CINIT 
+RESP 
+RESP 
BIND 


+RESP 


+RESP 


SESSST SESSST 
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Figure 136. Dependent SLU Initiating a Cross-Domain Session with Application LU 
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Figure 137. SLU Initiating Request for Single Gateway VTAM and Single Gateway NCP 
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1. LU1 is initiating a session with DLUX. Using alias name translation, SSCP1 
translates DLUX to LU2 and LU1 to OLUX. 


2. Names are sent to allow substitution in the BIND. 
3. The CINIT drives the logon exit. 
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+RESP (a) 
+RESP (a) 


Figure 138. SLU -Initiating Request for Single Gateway Connecting Three or More Networks 
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Gateway for Network A, Gateway for Network A, Gateway 
LUI SSCP1 Network B and SSCP2 Network B and SSCP3 SSCP3 _LU3 
(SLU) Network A Network C Network B Network C Network C (DLU) (PLU) 
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+RESP (CDCINIT) CINIT 
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BIND (DLUX,LU1) 


+RESP| (DLUX ,LU1) 


+RESP (LU3,0LUX) 


+RESP (LU3,OLUX) 


Figure 139 (Part 1 of 2). SLU Initiating Request for Predesignated Control of Gateway 


NCP by Middle Host 
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Gateway NCP (1) Gateway NCP (1) 
Gateway for Network A, Gateway for Network A, Gateway 
LUI SSCP1 Network B and SSCP2 Network B and SSCP3 SSCP3 LU3 
(SLU) Network A Network C Network B Network C Network C (DLU) (PLU) 
NOTIFY 
NOTIFY 
+RESP 
+RESP NOTIFY 
SESSST 
SESSST 
+RESP 
CDSESSST 
COSESSST 
CDSESSST 


+RESP 


+RESP 


Figure 139 (Part 2 of 2). SLU Initiating Request for Predesignated Control of Gateway 
NCP by Middle Host 


1. To simplify the flow, the gateway NCP has been shown twice in this flow. 
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COSESSEND : 


+RESP 


CDINIT (DQ) 


CDOCINIT 
CINIT 
LOGON 
EXIT 


OPNDST 
ACCEPT 
+RESP 


SCIP EXIT 
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EU3 


+RESP SCIP EXIT 


Figure 140. Third-Party Initiating CLSDST PASS 
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Initiating SSCP of SSCP of 
EU1 PLUI SSCP1 EU2 PLU2 PLU2 SLU3 SLU3 EU3 
CLSDST 
PASS INITIATE INITIATE 
OTHER OTHER 
cD 
CDINIT (Q) 
+RESP (queued) 
+RESP 
+RESP 
SESSEND 
OPNDST 
ACCEPT 
SCIP EXIT 
OPNSEC 
NOTIFY | 


NS EXIT 


Figure 141. Third-Party Initiating CLSDST PASS with NOTIFY 
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Gateway NCP1 Gateway NCP2 
LU1 Gateway for Network A Gateway LU2 for Network C Gateway LU3 
(ILU) SSCP1 SSCP1 and Network C SSCP2 (SLU) and Network B SSCP3 (PLU) 


INIT_OTHER 
(LU2,LU3) 


INIT_OTHER_CD 
(LU2,LU3) 


INIT_OTHER_CD 
(LU2,LU3) INIT_OTHER CD 


(LU2,LU3) 


CDINIT (LU2,LU3) | CDINIT 
(LU2,LU3) 


RNAA 
+RESP 


SETCV 
(address map) 


+RESP 

+RESP (CDINIT, 
+RESP (CDINIT, |address of LU3) 
address of LU3) 


SETCV 
(name, VR list) 


+RESP (INIT_| +RESP 


CDCINIT 
CDCINIT 
+RESP 
+RESP 
CINIT 
+RESP 
BIND 
BIND 
+RESP 
NOTIFY 
SESSST 
+RESP 
NOTIFY 
SESSST 
CDSESSST 
CDSESSST 
NOTIFY +RESP (CDSESSST) 
NOTIFY KEY 63 
NOTIFY KEY 93 +RESP 
NOTIFY KEY 63 (CDSESSST) 


KEY 03 


Figure 142. Third Party Initiating Request Spanning Three Networks 
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EU PLU 


CINIT 


LOGON EXIT (2) 
OPNDST ACCEPT (2) 


+RESP 


SESSST 


+RESP 


+RESP (2) 


SSCP of PLU 


Operator's 


SSCP of SLU SLU Console 


| 
VARY NET,LOGON 
DSRLST (1) 
+RESP 


CDINIT 


+RESP 


“LOGON SUCCESSFUL” 


CDOCINIT 


+RESP 


+RESP 


CDSESSST 


SESSST 


Session Establishment Flows 


Figure 143. Initiating Session Using VARY NET,LOGON or LOGAPPL 


1. Optional; occurs only when SLU is a dial device. 


2. This applies only when the PLU is associated with an application program. It 
does not appear in the flow if the PLU is a device-type logical unit. 
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(INIT OTHER) | 


~CDCINIT 
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BIND 
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Figure 144. Notification of PLU Availability for Autologon 


1. This applies only when the PLU is associated with an application program. It 
does not appear in the flow if the PLU is a device-type logical unit. 
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Gateway NCP 
LU1 Gateway for Network A LU2 
(SLU) SSCP1 SSCP1 and Network B SSCP2 (PLU) 


INIT SELF 
(DLUX) CDINIT 


(DLUX, LU1) 


COINIT 
(LU2, LU1) | CDINIT 
(LU2, LU1) 


CDTERM 
(CDINIT RESP) 


CDTERM 
(CDINIT RESP) 


NOTIFY 
(set up 
failure) 


CDTERM 
(CDINIT RESP) 


|-RESP (INIT) 


Figure 145. Failure (CDINIT Rejection) of Session Initiation by an SLU for Single Gateway 
VTAM and Single Gateway NCP 
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LU2 
(PLU) 


Figure 146. Failure (SETCV Failure) of Session Initiation by an SLU for Single Gateway 


VTAM and Single Gateway NCP 
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Gateway NCP 
LU1 Gateway for Network A LU2 
(SLU) SSCP1 SSCP1 and Network B SSCP2 (PLU) 


INIT_SELF 
(DLUX) 


CDINIT 
(DLUX,LU1) 


COINIT 
(LU2, LU1) 


CDINIT 
(LU2, LU1) 


+RESP 
(address of 
LU2) 


+RESP 
(CDINIT, 

address of 
DLUX) 


+RESP (INIT) 
CDCINIT 
CDOCINIT 


COCINIT 


CDTERM (set 


up failure) 


NOTIFY 
(set up 
failure) 


NSPE or CDTERM (set| (NOTIFY) 
NOTIFY up failure) 

(reject at 

PLU) 


Figure 147. Failure (CINIT Rejection) of Setup Procedure Initiated by an SLU for Single 
Gateway VTAM and Single Gateway NCP 
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Deactivation and Session Termination Flows 


Figure 148 on page 978 through Figure 173 on page 999 show the flow of 
requests and responses between the SSCP and logical and physical units to deac- 
tivate resources and end sessions. 


Index of Deactivation and Session Termination Flows 


Table 68 lists the deactivation and session termination flows that are illustrated 
here. 


Table 68 (Page 1 of 2). Index of Deactivation and Session Termination Flows 


Flow Page 
CLOSE ACB processing Figure 163 on page 990 
Deactivating an application program Figure 164 on page 991 
Deactivating a CDORM 
Forced j Figure 167 on page 993 
Forced, without affecting active sessions Figure 169 on page 995 
_ Forced or immediate, VTAM releases prior to V3R4.1 — Figure 170 on page 996 
Immediate Figure 166 on page 993 
Immediate, without affecting active sessions Figure 168 on page 994 
Normal : Figure 165 on page 992 
Deactivating a logical unit (LU), single network 
Forced | Figure 149 on page 978 
Immediate Figure 148 on page 978 
VARY NET,TERM Cleanup Figure 161 on page 988 
VARY NET,TERM Unconditional Figure 160 on page 987 
With Giveback Figure 150 on page 979 
Deactivating a logical unit (LU), multiple networks 
Independent PLU sends BFCLEANUP for independent SLU Figure 151 on page 980 
Independent PLU sends UNBIND for independent SLU Figure 152 on page 980 
PLU sends UNBIND for multiple gateway VTAMs and single Figure 153 on page 981 


gateway NCP 


PLU sends UNBIND for single gateway VTAM and single gateway Figure 154 on page 981 
NCP 


SLU requests TERMINATE SELF (CLEANUP) for single gateway Figure 156 on page 983 
VTAM and single gateway NCP 


SLU requests TERMINATE SELF for multiple gateway VTAMs and Figure 155 on page 982 
back-to-back gateway NCPs 


SLU requests TERMINATE SELF for single gateway VTAM and Figure 157 on page 984 
single gateway NCP 


Type 2.1 nodes, active termination Figure 158 on page 985 


Deactivating a physical unit (PU) acting as an adjacent link Figure 159 on page 986 
station for independent logical unit (LU) sessions 


Queued session, terminating Figure 162 on page 989 
Route failure 


Route failure in intermediate network causes termination of LU-LU Figure 172 on page 998 
sessions 
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Table 68 (Page 2 of 2). Index of Deactivation and Session Termination Flows 
Page 
Figure 173 on page 999 


Flow 

Route failure in intermediate network causes termination of 
SSCP-SSCP sessions 

SSCP-SSCP session termination causes LU-LU sessions to be 
broken 


Figure 171 on page 997 
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Operator's uration Session of 
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OTHER (F) 
CDTERM (F) 
+RESP 
CTERM (F) 
+RESP 
+RESP 
+RESP 
SESSEND 
CDSESSEND 
NOTIFY 
+RESP 
DACTLU (1) 
+RESP (1) 


+RESP (1) 
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EU 


LOSTERM 


CLSDST 


Figure 148. Deactivating a Logical Unit: Immediate 


1. These flow only when the operator deactivates a specific logical unit. 


For 


example, they do not flow during immediate deactivation of a CDRM. 


SSCP SSCP 
Operator's Configuration Session SSCP of 
Console Service Service SLU PLU PLU EU 


V NET,INACT, 
ID=LU name,F (1) 
TERM OTHER(C) 


NOTIFY 


+RESP 
+RESP (1) 


Figure 149. Deactivating a Logical Unit: Forced 


1. These flow only when the operator deactivates a specific logical unit. 


For 


example, they do not flow during forced deactivation of a CDRM. 
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SSCP SSCP 
Operator's Session Configuration 
Console Services Services NCP 


V NET,INACT, 
ID=LINK, G 


DACTLINK(G) 


TERM OTHER (1) 
(QUEUED/PENDING 
SESSIONS) 


NOTIFY 


SWAP ACTIVE SESSIONS (2) 
FROM LU TO CDRSC 


Message 
IST165I 
Node 
Inactive 


Figure 150. Deactivating a Logical Unit with Giveback 


1. The DACTLINK X'02' terminates only queued and pending LU-LU sessions. 
Active LU-LU sessions remain active. 


2. After session services transfers SIBs of ACTIVE logical units to the CDRSC, 
configuration services SRTADDs the CDRSCs as real resources, and the 
logical units are ADDed as shadow resources. If a CDRSC for a particular 
logical unit does not exist, a dynamic CDRSC is allocated for the logical unit. 
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LU1 BF BF LU1 
(PLU) (PLU) SSCP1 SSCP2 (SLU) (SLU) 
(1) 
+—— 
BFCLEANUP 
CDSESSEND 
UNBIND +RESP 
(CLEANUP) 
; r 
+RESP (BFCLEANUP) BFSESSEND 
FNA FNA 
+RESP (FNA) +RESP 


Figure 151. Independent Primary Logical Unit (PLU) Sends BFCLEANUP for Cross-Domain 
LU-LU Session with Independent Secondary Logical Unit (SLU) 
1. BFCLEANUP can be sent by the SSCP(PLU) for several reasons, including: 


e A network operator at the SSCP(PLU) issues a VARY 
NET, TERM,UNCOND, generating an internal TERM-OTHER(forced). 


e A network operator at either SSCP issues a VARY NET,INACT,ID=cdrm, 
deactivating all cross-domain sessions between the SSCPs. 


LUI BF BF LU1 
(PLU) (PLU) SSCP1 SSCP2 (SLU) (SLU) 
UNBIND 
a ee ee 
BFSESSEND BFSESSEND 
CDSESSEND 
+RESP 
(CDSESSEND) 
FNA FNA 
+RESP(FNA) +RESP(FNA) 


Figure 152. Independent Primary Logical Unit (PLU) Sends UNBIND for Cross-Domain 
LU-LU Session with Independent Secondary Logical Unit (SLU) 
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Gateway NCP 
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(SLU) SSCP1 SSCP1 and Network B SSCP2 
UNBIND 
UNBIND 
+RESP (UNBIND) cw scl 
+RESP (UNBIND) 
NOTIFY 
(SESSION END) 
+RESP 
(NOTIFY) 
CDSESSEND (a) 
CDSESSEND (b) 
CDSESSEND (b) 
+RESP 
+RESP (CDSESSEND(b) ) 
(CDSESSEND(a))| +RESP 
(CDSESSEND(b) ) 
SESSEND 


Deactivation Flows 


LU2 
(PLU) 


SESSEND 


Figure 153. Primary Logical Unit (PLU) Sends UNBIND for Multiple Gateway VTAMs and 


Single Gateway NCP 


Gateway NCP 


Gateway 


LU1 Gateway for Network A LU2 
(SLU) SSCP1 SSCP1 and Network B SSCP2 (PLU) 
UNBIND 
UNBIND 
“RESP (UNBIND)| 
+RESP (UNBIND) 
NOTIFY 
(SESSION END)| NOTIFY 
(SESSION END) 
+RESP (NOTIFY) 
+RESP (NOTIFY) 
CDSESSEND (a) 
CDSESSEND (b) 
CDSESSEND (b) 
SESSEND 
SESSEND +RESP 
+RESP (CDSESSEND(b)) 
(CDSESSEND(a) ) | +RESP 
(CDSESSEND(b)) 


Figure 154. Primary Logical Unit (PLU) Sends 
Single Gateway NCP 
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Gateway NCPl1 Gateway NCP2 


LU1 Gateway for Network A_ for Network C Gateway LU2 
(SLU) SSCP1 SSCP1 and Network C and Network B SSCP2 (PLU) 
TERM_SELF 
CDTERM 
+RESP COTERM 
CDTERM 
CDTERM 
CTERM 
+RESP 
+RESP (CDTERM) +RESP 
(CDTERM) (CTERM) 
+RESP(CDTERM) 
+RESP(CDTERM) 
UNBIND 
UNBIND 
UNBIND 
+RESP 
(UNBIND) +RESP 
(UNBIND) 
NOTIFY 
(SESSION END) 
+RESP +RESP 
(NOTIFY) (UNBIND) 


CDSESSEND (a) | CDSESSEND 
CDSESSEND (b) (a) NOTIFY 
(SESSION END) 


CDSESSEND (a) 


+RESP 
(NOTIFY) 
+RESP SESSEND 
CDSESSEND (b) +RESP 
+RESP (CDSESSEND 
+RESP (CDSESSEND| (a)) 
(CDSESSEND | (a)) 
SESSEND (a)) 


Figure 155. Secondary Logical Unit (SLU) Requests TERMINATE SELF for Multiple 
Gateway VTAMs and Back-to-Back Gateway NCPs 
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Gateway NCP 
LU1 Gateway for Network A LUZ 
SLU) SSCP1 SSCP1 and Network B SSCP2 (PLU) 


TERM_SELF, 
(CLEANUP) 


CDTERM 
(CLEANUP) 


DACTLU (1) 


NOTIFY 


CDTERM 


(CLEANUP) 


CDTERM 
(CLEANUP) 


+RESP 
(CLEANUP) 


+RESP 
(NOTIFY) 


Figure 156. Secondary Logical Unit (SLU) Requests TERMINATE SELF (CLEANUP) for 
Single Gateway VTAM and Single Gateway NCP 
Note: The UNBIND can flow from the SLU, the PLU, or the gateway NCP. 


1. A DACTLU does not flow to a binary synchronous communication (BSC) ter- 
minal. 


2. You might receive sense code 081E0003, indicating that cleanup has already 
occurred. 
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Gateway NCP 


LU1 Gateway for Network A LU2 
(SLU) SSCP1 SSCP1 and Network B SSCP2 (PLU) 
TERM_SELF 
CDTERM 
+RESP CDTERM 


+RESP (CDTERM) 


UNBIND 


CDSESSEND (a) 


SESSEND 
+RESP 


(CDSESSEND (a))|+RESP 
>| (CDSESSEND (b)) 


CDTERM 


CDTERM 


+RESP (CDTERM) 
+RESP (CDTERM) 
+RESP (CDTERM) 


UNBIND 


+RESP (UNBIND) 
NOTIFY 
(SESSION END) 
+RESP (NOTIFY) 


CDSESSEND (b) 


CDSESSEND (b) 


SESSEND 


+RESP 
(CDSESSEND (b)) 


Figure 157. Secondary Logical Unit (SLU) Requests Terminate Self for Single Gateway 
VTAM and Single Gateway NCP 


Note: (a) and (b) are used here to differentiate between similar request units. 
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Gateway NCP1 Gateway NCP2 


LU1 Gateway for Network A for Network C Gateway LU2 
SLU) SSCP1 SSCP1 and Network C and Network B SSCP2 (PLU) 
TERM_SELF 
CDTERM 
+RESP COTERM 
CDTERM 
CDTERM 
CTERM 
+RESP 
+RESP (CDTERM) | +RESP 
(CDTERM) (CTERM) 
+RESP (CDTERM) 
+RESP UNBIND 
(CDTERM) 
UNBIND 
UNBIND 
+RESP 
(UNBIND) +RESP 
(UNBIND) 
NOTIFY 
SESSEND (SESSION END) 
+RESP +RESP 
(NOTIFY) (UNBIND) 
CDSESSEND (a) 
CDSESSEND CDSESSEND |NOTIFY 
(b) (a) (SESSION 
END) 
CDSESSEND 
(a) 
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+RESP (NOTIFY) 
CDSESSEND 
(b) +RESP 
+RESP CDSESSEND 
CDSESSEND | (a) 
+RESP (a) 
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Figure 158. Active Session Termination of Type 2.1 Nodes 
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SLU SS PUNS BFSS cS NOS PLU 
V INACT, 1D=PU1,F 
V INACT NCSPL 


TERM OTHER(PUNAME) 
BFCLEANUP 


UNBIND to SLU | UNBIND to PLU one 


set 
per 
Session Ended session (1) 


Session Ended 


NOTIFY(03) (2) 
Final LU Deactivation 
"PU INACTIVE" Message 


Figure 159. Deactivating a PU Acting as an Adjacent Link Station for Independent LU Ses- 
sions 


1. Examines PLU and SLU chain and sends (BF)CLEANUP for each ILU session 
found. 


2. When all Session Ended (or BFSESSEND) signals are received, NOTIFY is 
sent to CS for PU. 


In this example, PU1 is a fictitious adjacent link station. When the PU is deacti- 
vated, configuration services sends a TERMINATE containing the PU name to 
session services. Session services examines the adjacent link station's SIB chains 
and sends CLEANUP to terminate the sessions. When all sessions are down, 
NOTIFY flows to configuration services so the final deactivation can occur. 
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PLU for an Application Program 


Operator SSCP PLU for 
Operator's Command Session LU Application 
Console Interface Services Services Program SLU 


VARY NET,TERM 
Unconditional 
Term other (F) 


CTERM(FORCE) (1) 
LOSTERM 

+RESP 

UNBIND 


+RESP 


Message 
IST4551 
Sessions Ended 


SESSION END 


Device-Type PLU 


Operator SSCPDevice- 
Operator's Command Session Type 
Console Interface Services PLU SLU 


VARY NET, TERM 
Unconditional 
Term other (F) 


CTERM(FORCE) 


UNBIND 


Message SESSION END 
IST4551 


Sessions Ended 


SESSEND 


Figure 160. Deactivating Sessions or LUs Using VARY NET, TERM Unconditional 


1. If the LOSTERM exit routine is already scheduled with a reason code 32 
caused by a CTERM (orderly) request that was received before, the CTERM 
(force) request is upgraded to a CLEANUP RU and VTAM drives an NSEXIT 
exit routine. 
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PLU for an Application Program 


SscP PLU for 
Operator's Session Application 
Console Services LU Services Program SLU 


VARY NET, TERM 
Cleanup 


Cleanup in 
progress 


CLEANUP 


CLEANUP 


NSEXIT 


Schedule Reset 
for SLU 


Message 
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Sessions Ended 


Device-Type PLU 


SScP 
Operator's Session Device-Type 
Console Services PLU SLU 


VARY NET, TERM 
Cleanup 


Cleanup in 
progress 


CLEANUP 
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for SLU 
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Figure 161. Deactivating Sessions or LUs Using VARY NET, TERM Cleanup 
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Figure 162. Terminating A Queued Session 
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Configuration Session 
EU OPEN/CLOSE  LUS PUNS Services TSC Services 


CPWAIT 
(DACTLU completion) 


NOTIFY 


DACTLU 


DACTLU 


CPWAIT 
(LUCB deletion) (1) 


DELETENR 
DELETENR 


CPPURGE 


+RESP 
DELETENR 


Figure 163. CLOSE ACB Processing 


1. PUNS cannot send a response to the CLOSE ACB AMRU until DACTLU proc- 
essing is complete and the LUCB has been deleted. Therefore, after 
requesting that configuration services deactivate the logical unit, PUNS issues 
CPWAIT and waits for LUS to post it when the logical unit has been deacti- 
vated. Once it is posted, PUNS waits to be notified that there are no more 
active sessions for the application program. PUNS issues CPWAIT and waits 
for configuration services and TSC to send a request to delete the LUCB. 
PUNS posts itself when it has processed each of these requests and sends a 
response to configuration services to notify it that the LUCB has been deleted. 
After sending this response, PUNS sends a response to the CLOSE ACB 
AMRU. 


For the open ACB flow see Figure 114 on page 943. 
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VTAM 
EU OPEN/CLOSE LUS PUNS SSCP TSC Operator 


V NET, INACT, ID=APPL 


DACTLU 


+RESP DACTLU 


DELETENR 


Message IST10®5I 
Node Now Inactive 


CLOSE ACB 


CLOSE ACB AMRU 


CPWAIT 
(LUCB deletion) (1) 


DELETENR 


CPPURGE 


+RESP 
DELETENR 


Figure 164. Deactivating an Application Program 


1. PUNS cannot send a response to the CLOSE ACB AMRU until there are no 
more active sessions for the application program. Therefore, after the SSCP 
sends a request to delete the LUCB, PUNS waits for OPEN/CLOSE to send it 
a CLOSE ACB AMRU. Once it has received this request, PUNS issues 
CPWAIT and waits for TSC to send a request to delete the LUCB. PUNS 
posts itself when it has deleted the LUCB and sends a response to configura- 
tion services. After sending this response, PUNS sends a response to the 
CLOSE ACB AMRU. 
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Operator's 
Console SSCP1 SSCP2 


V NET,INACT, 
ID=SSCP2 


Terminate all 
queued user 
sessions (1) 


Terminate al] 
queued user 
sessions (1) 


CDTAKED 


All queued user 
sessions terminated (1) 


All queued user 
sessions 
terminated (1) 


CDTAKEDC 


CDTAKEDC 


DACTCDRM 


Message IST1@5I 
Node Now Inactive 


Figure 165. Deactivating a CDRM: Normal 


Note: When the CDRM is actually deactivated, immediate processing takes place. 
See Figure 166 on page 993 for the RUs that flow for immediate deactivation of a 
CDRM. 


1. See Figure 162 on page 989 for the RUs that flow for termination of a queued 
session. 
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Operator's 
Console SSCP1 SSCP2 


Vv NET, INACT, 
ID=SSCP2,1 Terminate al] 


user sessions (1) 


CDTAKED Terminate all 


user sessions (1) 


User sessions 
terminated (1) 
User sessions 
terminated (1) 


COTAKEDC 


CDTAKEDC 


DACTCDRM 


Message IST105I 
Node Now Inactive 


Figure 166. Deactivating a CDRM: Immediate 


1. The logical unit will not be deactivated. See Figure 161 on page 988 for the 
RUs that flow for immediate deactivation of a logical unit. 


Operator's 
Console SSCP1 SSCP2 


V NET, INACT, 
ID=SSCP2,F Terminate all 


user sessions (1) 


CDTAKED Terminate all 


user sessions (1) 


DACTCDRM 


Message IST105I 
Node Now Inactive 


Figure 167. Deactivating a CDRM: Forced 


1. The logical unit will not be deactivated. See Figure 161 on page 988 for the 
RUs that flow for forced deactivation of a logical unit. 
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SSCP2A 
Supports SAVESESS (V3R4.1) 


SSCP1A 
Supports SAVESESS (V3R4.1) 


line 
Operator's 
Console 


V NET, INACT 
ID=SSCP2A,1,S 


VARY INACT NCSPL 
CDTAKED (queued, pending) 


TERM_OTHER 


TERM_OTHER | OT 
(queued , pending) 


(queued, pending) 


+RESP (CDTAKED) 
CDTAKEDC 


CDTAKEDC 


DACTCDRM(SOFT) 


TERM_OTHER 
(queued, pending) 


+RESP (DACTCDRM) 


Figure 168. Deactivating a CDRM Without Affecting Active Sessions: Immediate 
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SSCPI1A SSCP2A 
Supports SAVESESS (V3R4.1) Supports SAVESESS (V3R4.1) 
line 
Operator's SS CDRM 
Console 


V NET, INACT 
ID=SSCP2A,F,S 


VARY INACT NCSPL 
CDTAKED (queued, pending) 


TERM_OTHER 


TERM_OTHER 
(queued, pending) 


(queued, pending) 
+RESP (CDTAKED) 
DACTCDRM(SOFT) 


TERM OTHER 
(queued, pending) 


+RESP (DACTCDRM) 


Figure 169. Deactivating a CDRM Without Affecting Active Sessions: Forced 
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SSCP1A 
Supports SAVESESS (V3R4.1) 


V NET, INACT,ID=SSCP2A,F,S 


SSCP2A 
Does not support SAVESESS 
(Prior to V3R4.1) 


Operator's 
Console 


or 
V NET, INACT, ID=SSCP2A,1,S 
VARY INACT NCSPL 


DACTCDRM(SON) 


TERM_OTHER 
(queued, pendin 


) 
+RESP (DACTCDRM) | | 


If automatic recovery is specified on both nodes, the following flows also: 
= 


-RESP (SENSE 68580001) (1) 


Figure 170. Deactivating a CDRM on a VTAM Level Prior to V3R4.1: Forced or Immediate 


1. When automatic recovery is specified on both nodes, a CDRM V3R4.1 
responds to ACTCDRM(RECOVERY) by sending a negative ACTCDRM 
response with sense code 08580001 indicating that it rejects the attempt to 
restart the session that was terminated using a nondisruptive deactivation 
request. Active LU-LU sessions remain active. The external CDRM in the 
migration SSCP becomes inactive with sessions, and the external CDRM in the 
V3R4.1 SSCP becomes inactive. 


See VTAM Messages and Codes for information on sense code 08580001. 
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Gateway NCP 


LU3 Gateway for Network A Gateway LU2 
(PLU) SSCP1 SSCP1 and Network B SSCP2 (SLU) 
CDTAKED 
CDTAKED 
COTERM +RESP 
(address of +RESP 
LU3, address 
of LU2 
alias) 
COTERM 
+RESP 
+RESP 
UNBIND 
UNBIND 
+RESP 
+RESP (UNBIND) 
(UNBIND) 
NOTIFY 
NOTIFY (SESSION SESSEND 
(SESSION END) 
END) 


CDSESSEND (a) (1) 


CDSESSEND (b) (1) 


+RESP 
+RESP +RESP 
CDTAKEDC 


SESSEND 
DACTCDRM 
+RESP 


NOTIFY (1) 
(free 
trans form) 


+RESP 


Figure 171. SSCP-SSCP Session Termination Causes LU-LU Sessions to Be Broken 
Notes: 
e A cross-network LU-LU session exists between LU3 and LU2. 


e This flow assumes that the gateway VTAM1 established the network 
address translation for the gateway VTAM1-to-gateway VTAM2 session 
with the RNAA RU. The NOTIFY to free the transform is sent only if 
the RNAA that established the address specified “retain address.” 


e (a) and (b) are used here to differentiate between similar request units. 


1. For details of CDSESSEND processing, see the other flow diagrams listed in 
“Index of Deactivation and Session Termination Flows” on page 976. 
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PU Type 4/ 

PU Type 5 
Gateway Inter- Gateway 
NCP1l for mediate NCP2 for 
Network A Routing Network C 


Gateway and Node (Net- and Gateway LU2 
(SLU) SSCP1 SSCP1 Network C work C) Network B SSCP2 (PLU) 
NC_ER_INOP 
NC_ER_INOP 
UNBIND (VR_INOP) > 


UNBIND (VR_INOP) 
+RESP (UNBIND) 


NOTIFY 
(SESSION END) 


CDSESSEND 
COSESSEND 


+RESP 
SESSEND 
(CDSESSEND) | +RESP 


+RESP (UNBIND) 


NOTIFY 
(SESSION END) 


+RESP 


Figure 172. Route Failure in Intermediate Network Causes Termination of LU-LU Sessions 


Note: An outage occurs on the route in Network C used by the LU1_LU2 session. 
ER_INOP reports the failure to gateway NCP1 and gateway NCP2. 


998  VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Gateway NCP1 


Gateway for Network A 
and Network C 


SSCP1 SSCP1 


DACTCDRM 
(VR_INOP) 


+RESP 
(DACTCDRM) 


NOTIFY (free 
transform) (1) 


ER_INOP 


Deactivation Flows 


PU Type 4/ 

PU Type 5 

Intermediate Gateway NCP2 

Routing Node for Network C Gateway 
(Network C) and Network B SSCP2 


ER_INOP 


DACTCDRM 
(VR_INOP) 


+RESP 
(DACTCDRM) 


NOTIFY (free 
transform) (1) 


+RESP 


Figure 173. Route Failure in Intermediate Network Causes Termination of SSCP-SSCP Ses- 


sions 


Note: An outage occurs on the route in Network C used by the gateway 
VTAM1-to-gateway VTAM2 session. The failure is reported to gateway NCP1 and 
gateway NCP2 with an ER INOP RU. 


1. The NOTIFY to free the transform is sent only if the RNAA that established the 
address specified “retain address.” 
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Error Detection and Recovery and SSCP Management Services 


Figure 174 on page 1001 through Figure 176 on page 1003 show the flow of 
requests and responses between the SSCP and logical and physical units to 
handle error recovery processing (ERP) and route Forward and Deliver RUs. 
Figure 177 on page 1003 through Figure 179 on page 1005 show the requests 
and responses between the NetView program, VTAM, the communications adapter 
and the local modem for LPDA-2 processing. Figure 180 on page 1006 through 
Figure 183 on page 1010 show the flow of requests and responses between the 
SSCP and logical and physical units to handle extended recovery facility 
(XRF) session establishments and takeovers with USERVARs. 


Index of Error Detection and Recovery and SSCP Management 
Services Flows 


Table 69 lists the error detection and recovery and SSCP management services 
flows that are illustrated here. 


Table 69. Index of Error Detection and Recovery and SSCP Management Services Flows 
Flow Page 


Error recovery processing (ERP) 


Hard INOP | | Figure 175 on page 1002 . 
Soft INOP | Figure 174 on page 1001 
- LPDA-2 processing 

Unsolicited LPDA-2 test on permanent link error with two link seg- Figure 179 on page 1005 
ments | | 
Unsolicited LPDA-2 test on thresholds reached for an LPDA-2 Figure 177 on page 1003 
physical unit (PU) with one link segment | 
Unsolicited LPDA-2 test on thresholds reached for an LPDA-2 Figure 178 on page 1004 


physical unit (PU) with two link segments 

SSCP management services processing 

FORWARD and DELIVER Routing | Figure 176 on page 1003 
XRF processing 


Secondary logical unit (LU) initiate with USERVAR (LOGON) Figure 182 on page 1009 
Third-party initiate (CLSDST PASS) | Figure 183 on page 1010 
XRF primary and backup sessions, establishment of Figure 180 on page 1006 
XRF session switch (takeover) Figure 181 on page 1008 
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SscP SscP 
Operator's Session Configuration LU 
Network Console Services Services Services PLU 


INOP (STATION) —SOFT— 
CONTACT 
PU_T2 
ERP in 
Progress 


TERMINATE 
CLEANUP 
CLEANUP 
CLEANUP 
RESP (1) 
NSEXIT or 
LOSTERM EXIT 
CLSDST (2) 
SESSEND 
NOTIFY 


Figure 174. Error Recovery Processing: Soft INOP 


1. If the NSEXIT exit routine is scheduled, LUS cleans up the session and sends 
a positive response to the cleanup request. If the LOSTERM exit routine is 
scheduled, LUS does not clean up the session, and it sends a negative 
response to the cleanup request. 


2. CLSDST flows only if the LOSTERM exit routine is scheduled. 
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SSCP SSCP 
Operator's Session Configuration LU 
Network Console Services Services Services PLU 


INOP (STATION) —HARD- 


Deactivation 
processing 
takes place 
for 
resources 
affected by 


the INOP. 
TERMINATE 
CLEANUP 
+RESP 
CLEANUP 
CLEANUP 
NSEXIT or 


+RESP (1) |LOSTERM EXIT 


CLSDST (2) 
SESSEND 


NOTIFY 


Figure 175. Error Recovery Processing: Hard INOP 


1. If the NSEXIT exit routine is scheduled, LUS cleans up the session and sends 
a positive response to the cleanup request. If the LOSTERM exit routine is 
scheduled, LUS does not clean up the session, and it sends a negative 
response to the cleanup request. 


2. CLSDST flows only if the LOSTERM exit routine is scheduled. 
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CNM SLU SscP PU 


FORWARD (RUx) (1) 


+RESP (RUx) 


+RESP (FORWARD) 


DELIVER (RUy) 


+RESP (RUy) 


+RESP (DELIVER) 


Figure 176. FORWARD and DELIVER Routing 


1. RUx is a maintenance service RU. 


2. Either RUy contains data in reply to RUx, or it is an unsolicited RU. 


Communi cation Local 
NETVIEW VTAM adapter modem 


LPDA-2 MLS 
channel program 


modem command 


modem response 


Channel End/Device End 


Deliver (NMVT) X'6@25' 


Response (Deliver) 


Figure 177. Unsolicited LPDA-2 Test on Thresholds Reached for an LPDA-2 PU with One 
Link Segment 
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Local Local 
Communication modem modem 
NETVIEW VTAM adapter (1st link) (2nd link) 


LPDA-2 MLS 
channel program (1) 
modem command 


modem response 


Channel End/Device End 


LPDA-2 MLS 
channel program (2) 


modem command 


modem response 


Channel End/Device End 


Deliver (NMVT) 


X'0025' 


Response (Deliver) 


Figure 178. Unsolicited LPDA-2 Test on Thresholds Reached for an LPDA-2 PU with Two 
Link Segments 


1. This MLS (modem and link status) command is for the first link segment. 


2. This MLS command is for the second link segment. 
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Local Local 
Communication modem modem 
NETVIEW VTAM adapter (1st link) (2nd link) 


LPDA-2 MLT 
channel program (1) 
modem command 


modem response 


Channel End/Device End 


LPDA-2 MLT 
channel program (2) 


modem command 


modem response 


Channel End/Device End 


Deliver (NMVT) 


X'6001' 


Response (Deliver) 


. One sequence for each 
. active LPDA-2 PU on 
. the link. 


Deliver (NMVT) 


X'9025' 


Response (Deliver) 


Figure 179. Unsolicited LPDA-2 Test on Permanent Link Error with Two Link Segments 


1. This MLT (modem and link test) command is for the first link segment. 


2. This MLT command is for the first active LPDA-2 PU on the second link 
segment. 
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SscP of SSCP of XRF 
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LOGON (G) or INIT(G) (2) 


+RESP 


CDINIT (G) (3) 
CDTERM (R) (3) 
CDINIT (R) 
+RESP 
CDCINIT (1) 


"LOGON SUCCESSFUL ' 
CINIT (1) 


+RESP 


+RESP 


BIND (4) 


+RESP : 
SESSST 
CDSESSST 
SDT 
(Session Tracking (5) 
Information) | 
(SIMLOGON) 
INIT 
CDINIT 


| RESP | 
CINIT 
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se 
SESSST SESSST 
rst 


pone = i 


Figure 180. Establishment of XRF Primary and Backup Sessions 


G Represents a generic USERVAR name 
R Represents a resolved USERVAR name 


1. These RUs or responses contain control vectors which indicate whether or not 
the SLU is eligible for an XRF backup session. 


2. A LOGON or INIT_SELF to an XRF application will generally use a generic 
(USERVAR) application name which is translated by VTAM to the real applica- 
tion name of the PLU that is currently the XRF active. 


3. These RUs are used to translate the generic (USERVAR) name used in the 
LOGON or INIT_SELF to the real name of the application that is currently the 
XRF active. They are present only if the SLU's SSCP does not already know 
the current value of the USERVAR or if the USERVAR's type is VOLATILE. 
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4. The BIND includes a correlator ID which will be used to relate this primary 
session to the corresponding backup session. 


5. The XRF Active application communicates information about the newly- 
established session, including the BIND correlator ID, to the XRF Alternate 
application. The XRF Alternate application uses this information when estab- 
lishing the corresponding backup session. 


6. The BIND includes a correlator ID which will be used to relate this backup 
session to the corresponding primary session. The BIND for the backup 
session terminates at the NCP; it is not visible to the actual device. 
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XRF 
Alternate SSCP BNN 
PLU of SLU NCP 
SWITCH 
+RESP 


(Session State Data 
Cont. Vector) 


(LU-LU Session Status 
Notify Vector) 


UNBIND (XRF Primary Hierarchical Reset) (1) 


+RESP (1) 


CDSESSEND (1) 


SESSEND (1) 


NOTIFY 


(LU-LU Session Status 
Notify Vector) 


Figure 181. XRF Session Switch (Takeover) 


1. Not present if XRF active PLU is not operational. 
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SSCP of SSCP of 
PL SLU 


Vy SLU EU 


EU PLU 


CDINIT(G) (1) 
CDTERM(R) (1) 
CDINIT(R) (1) 


+RESP 
**LOGON SUCCESSFUL” 


COCINIT 
CINIT +RESP 
LOGON EXIT 
+RESP 
OPNDST 
ACCEPT 
+RESP 
BIND 


SESSST SESSST 


CDSESSST 


SDT 


Figure 182. Secondary Logical Unit Initiate with USERVAR (LOGON) 


G Represents a generic USERVAR name 
R Represents a resolved USERVAR name 


1. These RUs are used to translate the generic (USERVAR) name used in the 

~ LOGON or INIT_SELF to the real name of the application that is currently the 
XRF active. They are present only if the SLU's SSCP does not already know 
the current value of the USERVAR or if the USERVAR's type is VOLATILE. 
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Initiating SSCP of SSCP of 


EU1 PLUI SSCP1 EU2 PLU2 PLU2 SLU3 SLU3 EU3 
INIT INITIATE 
OTHER OTHER 
cD 
CDINIT (Q) 


CDTERM (1) 


CDINIT (1) 


+RESP (queued) 
+RESP 


me | 


OPNDST 
ACCEPT 


Figure 183. Third-Party Initiate (CLSDST PASS) 


1. These RUs are used to translate the generic (USERVAR) name used in the 
LOGON or INIT_SELF to the real name of the application. They are present 
only if the SLU's SSCP does not already know the current value of the 
USERVAR or if the USERVAR's type is VOLATILE. 
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Dial and Answer for X.21 Switched Lines (VSE) 


Figure 184 illustrates the flow of requests and responses between the SSCP and 
X.21 switched lines attached through a communication adapter for dial and answer 
processing. 


Index of X.21 Switched Lines Flows 
Table 70 lists the X.21 Switched Lines flows illustrated here. 


Table 70. Index of X.21 Switched Lines Flows 


Flow Page 
Dial and answer for X.21 switched lines Figure 184 
TSC TSC 
Connection Channel End Communication 
SSCP PUS Manager Appendage Adapter X.21 


CONNOUT 
CCNNOUT 
+RESP (CONNOUT) 


+RESP (CONNOUT) Dial CP 


REQCONTACT 
ACTCCNNIN 
ACTCONNIN 


+RESP (ACTCONNIN) 


+RESP (ACTCONNIN) 


incoming call 


REQCONTACT 


Figure 184. Dial and Answer for X.21 Switched Lines 
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Appendix F. APPN Flows 


This appendix describes the flows between APPN end nodes, network nodes, inter- 
change nodes, and the subarea network. The flow diagrams are divided into the 
following categories: 


“CP-CP Session Flows” on page 1018 
“Directory Services Flows” on page 1028 
“LU-LU Session Flows” on page 1057 
“Dependent LU Server Flows” on page 1098. 


Table 71 on page 1014 lists all the APPN flows illustrated here. 
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Table 71 (Page 1 of 3). Index of APPN Flows 
CP-CP Session Flow 

Activating a CP-CP conloser session 

Activating a CP-CP contention winner session 
Activating an APPN Host-to-Host Channel 

Activating a leased APPN Node type 2.1 

Host CP initiating deactivation of CP-CP session 
Remote node initiating deactivation of CP-CP session 
Dependent LU Server Flow 

Single Subnetwork 

Activating resources 

CPSVRMGR pipe activation, DLUR-Initiated 
CPSVRMGR pipe activation, DLUS-initiated 
Dependent LUs, dynamic registration and activation of 
Dependent LUs, activation of pre-defined 

Physical Unit (PU), dynamic activation of 

SSCP-PU session activation race 

Deactivating resources 

CPSVRMGR pipe deactivation 


Downstream PU outage 


REQDISCONT (immediate) received from downstream PU 


REQDISCONT (normal) received from downstream PU 
LU-LU sessions 

APPN PLU-initiated to a dependent SLU 
Session termination, USS flows for 

USS SLU-initiated to APPN PLU 

USS SLU-initiated to subarea PLU 
SSCP-PU, SSCP-LU session deactivation 
Forced 

Normal 

With Giveback (ANS=CONT) 

With Giveback (ANS=STOP) 

Cross Subnetwork 


PLU-Initiated Session with DLUS and DLUR within Different Sub- 


networks 


PLU-Initiated Session with DLUS and PLU in one Subnetwork and 


DLUR in Another 


SLU-Initiated Session with DLUS and DLUR within Different Sub- 


networks 
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Figure 185 on page 
Figure 190 on page 
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Figure 244 on page 
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Figure 245 on page 
Figure 248 on page 


Figure 249 on page 
Figure 250 on page 
Figure 252 on page 
Figure 251 on page 


Figure 257 on page 
Figure 260 on page 
Figure 258 on page 
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Figure 254 on page 
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Table 71 (Page 2 of 3). Index of APPN Flows 
Directory Services Flow Page 


Locate resource 


APPN and Subarea Network Figure 202 on page 1048 
APPN network, complex Figure 199 on page 1040 
Complex APPN network using more than one CDS Figure 200 on page 1042 
CP-CP session terminates Figure 204 on page 1054 
CP network broadcast initiation Figure 197 on page 1037 
EN to NN Figure 193 on page 1032 
EN to NN to EN Figure 194 on page 1033 
EN to NN to NN to NN Figure 196 on page 1036 
EN to NN to subarea network Figure 198 on page 1039 
EN to NN to two ENs Figure 195 on page 1034 
NN receives network broadcast request Figure 205 on page 1055 
NNS of the OLU is at pre-V4R2 level Figure 201 on page 1045 
SLU-initiated session , Figure 203 on page 1052 
Register resource 

EN to NN to CDS Figure 191 on page 1029 
With error recovery Figure 192 on page 1031 
LU-LU Sessions Flow Page 

APPN network...NNS--EN (PLU) 

SLU-initiated, no queueing Figure 213 on page 1066 
SLU-initiated, queued by the PLU Figure 214 on page 1067 
APPN network...NNS--EN(SLU) 

PLU-initiated, no queueing Figure 211 on page 1064 
PLU-initiated, queued by the SLU Figure 212 on page 1065 
APPN network (PLU)...ICN==SA(SLU), PLU-Initiated 

Directed search without required precompututed RSCV Figure 236 on page 1090 
No queueing Figure 235 on page 1089 
Queued by SLU Figure 238 on page 1092 
Search-only flow transformed into a DSRLST Figure 234 on page 1088 
USERVAR resolution required Figure 237 on page 1091 
APPN network (PLU)...ICN==VR-based TG==ICN...APPN 

network (SLU) 

PLU-initiated Figure 242 on page 1097 
APPN network (SLU)...ICN==SA(PLU) 

Autologon, PLU not available initially Figure 241 on page 1096 
SLU-initiated, no queueing Figure 239 on page 1093 
SLU-initiated, queued by the PLU Figure 240 on page 1094 
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Table 71 (Page 3 of 3). Index of APPN Flows 

CLSDST PASS; SLU is single-session capable 

From APPN to subarea Figure 231 on page 1085 
Through APPN Figure 230 on page 1084 


EN-NN-EN, PLU-initiated, no queueing (including BIND flows for Figure 232 on page 1086 
intermediate network node) 


EN (PLU)--NNS...APPN network 


PLU-initiated, no queueing | Figure 206 on page 1059 
PLU-initiated, queued by the PLU Figure 207 on page 1060 
PLU-initiated, queued by the SLU Figure 208 on page 1061 
EN (SLU)--NNS...APPN network 

SLU-initiated, no queueing Figure 209 on page 1062 
SLU-initiated, queued by the PLU Figure 210 on page 1063 


Intermediate Network Node (INN) BIND. The LOCATE did not go Figure 233 on page 1087 
through this node. 


SA (PLU)==ICN...APPN network (SLU) 


DSRLIST transforming into PLU-initiated, search-only Figure 215 on page 1068 
PLU-initiated, no queueing Figure 216 on page 1069 
PLU-initiated, queued by the SLU © Figure 218 on page 1071 
PLU-initiated, USERVAR resolution required Figure 217 on page 1070 
SA (SLU)==ICN....APPN network (PLU) 

Autologon, PLU not available initially Figure 221 on page 1076 
SLU- initiated, no queueing Figure 219 on page 1073 
SLU-initiated, queued by the PLU Figure 220 on page 1074 
Lu-LU Session Flow Page 


" Session release request 


SA(PLU)==ICN...APPN network(SLU) Figure 228 on page 1083 
SA(SLU)==ICN...APPN network(PLU) Figure 229 on page 1083 
Session termination, forced 

SA(PLU)==ICN...APPN Network(SLU), pending active session. Figure 225 on page 1080 
PLU is accessible without going into APPN. 

SA(PLU)==ICN...APPN Network(SLU), queued session | Figure 226 on page 1081 
SA(PLU)==ICN...APPN Network(SLU), queued session. PLU is Figure 227 on page 1082 
accessible without going into APPN. 

SA(SLU)==ICN...APPN Network(PLU), pending active session | Figure 224 on page 1079 
Session termination, orderly 

SA(PLU)==ICN...APPN Network(SLU), active session Figure 222 on page 1077 
APPN Network(PLU)...ICN==SA(SLU), active session Figure 223 on page 1078 


Many abbreviations are shown at the top of the flow diagrams. The following list 
gives the meaning of those abbreviations: 


APPC Advanced-program-to-program communication program 
BF Boundary function 

CDS __ Central Directory Server 

CP Control point | 

DLUR Dependent logical unit requestor 

DLUS Dependent logical unit server 
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EN End node 

LU Logical unit 

NN Network node 

NNS Network node server 

PLU = Primary logical unit 

PU Physical unit 

PUNS Physical unit services 

SLU Secondary logical unit 

SSCP System services control point 
TP Transaction program 

TSC Transmission subsystem component 
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CP-CP Session Flows 


This section illustrates communication protocols between nodes in a mixed APPN 
2 and subarea network. Use these flows as guidelines to help analyze and isolate 
network problems caused by unexpected network events, such as protocol vio- 


lations. 


Index of CP-CP Session Flows 


Table 72 lists the CP-CP session flows illustrated here. 


Table 72. Index of CP-CP Session Flows 
Flow 

Activating a CP-CP conloser session 

Activating a CP-CP contention winner session 
Activating an APPN Host-to-Host Channel 
Activating a leased APPN Node type 2.1 

Host CP initiating deactivation of CP-CP session 


Remote node initiating deactivation of CP-CP session 


1018 VTAM V4R2 Diagnosis 


Page 

Figure 186 on page 1022 
Figure 185 on page 1019 
Figure 190 on page 1027 
Figure 189 on page 1026 
Figure 187 on page 1024 
Figure 188 on page 1025 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” CP-CP Session Flows 
Licensed Materials — Property of IBM 


Activating a CP-CP Contention Winner Session 


cp TP APPC SSCP BF 


(1) ADJACENT _CP_CONTACTED 
(2)START_TP (ACTICP_CP_SESSION) 
(3)ATTACH_TP 
(4) ALLOC, CONWIN 
(5)SIMLOGON 
(6)REQUEST_SINGLE_HOP_ROUTE 
7)REQUEST SINGLE HOP ROUTE Reply 
(8)RNAA 
(9)+RESP 
(16)Post SIMLOGON complete 
(11)OPNDST ACCEPT 
(12) BIND 
(13) +RESP 
(14)Post OPNDST complete 
4 
(15)Post ALLOC,CONWIN complete 
pe econ aes 
(16)SEND,DATA(Attach,CP Capabilities) 
(17)Post SEND,DATA| complete 
(18) RECEIVE,SPEC(CP Capabilities) 
(19)PIU(Attach,CP Capabilities) 
(26)PIU (CP Capabilities) 
(21)Post RECEIVE,SPEC complete 
22) ACT_CP_CP_SESSION_REPLY 


23) CP_STATUS (ACTIVE) 


Figure 185. CP-CP Contenion Winner Session Activation 


1. Configuration services sends an ADJACENT_CP_CONTACTED signal to the 
CP when the first link supporting CP-CP sessions is activated with an adjacent 
CP. 


2. The CP sends a START_TP signal to the APPC PAB to request initiation of the 
Request CP Capabilities Transaction Program (TP). An 
ACT_CP_CP_SESSION request is queued to the START_TP signal for proc- 
essing by the Request CP Capabilities TP. The ACT_CP_CP_SESSION initi- 
ates the activation of a contention winner CP-CP session with an adjacent 
node. 
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16. 


17. 


18. 


19. 


20. 
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. APPC sends an ATTACH_TP AMU for the Request CP Capabilities TP to TP 


Services. 


. The Request CP Capabilities TP issues an APPCCMD CONTROL=ALLOC, 


QUALIFY=CONWIN macroinstruction to allocate a conversation between the 
TP and the partner TP and a contention winner session between the local LU 
and the remote LU. 


. APPC issues a VTAM SIMLOGON macroinstruction to initiate a session in 


which APPC acts as the PLU. 


. Subarea session services sends a REQUEST_SINGLE_HOP_ROUTE signal to 


the CP to request the least-weight single-hop route from the origin to the desti- 
nation. 


. The CP sends to subarea session services the information requested in a 


REQUEST_SINGLE_HOP_ROUTE_REPLY. 


. RNAA flows if the CP-CP session is being set up over a type 2.1 link anda 


network address is needed. If the CP-CP session is being set up over a 
VR-based transmission group, CDINIT format 5 is sent to the session partner to 
get a network address. 


. The response is received from the boundary function. 
. LUS posts the SIMLOGON complete. 


. APPC issues an OPNDST ACCEPT macroinstruction to continue establishment 


of a session between APPC in this node (acting as the PLU) and APPC in the 
adjacent node (acting as the SLU). 


. The BIND for the contention winner session is transmitted to the adjacent node. 


. The BIND response for the contention winner session is received from the adja- 


cent node. 


. LUS posts the OPNDST ACCEPT complete. 
. APPC posts the APPCCMD CONTROL=ALLOC,QUALIFY=CONWIN complete, 


supplying the Request CP Capabilities TP a conversation ID and a contention 
winner conversation group ID (CGID). 


The Request CP Capabilities TP issues an APPCCMD CONTROL=SEND, 
QUALIFY=DATA macroinstruction to initiate the sending of this CP's CP Capa- 
bilities data to the adjacent CP. 


APPC posts the APPCCMD CONTROL=SEND,QUALIFY=DATA instruction 
complete, indicating that the output buffer has been filled with this CP's CP 
Capabilities data. 


At the request of the Request CP Capabilities TP, the Receive and Check CP 
Capabilities TP issues an APPCCMD CONTROL=RECEIVE, QUALIFY=SPEC 
macroinstruction to cause the transmission of this CP's CP Capabilities data to 
the adjacent CP, and to initiate the receiving of CP Capabilities data from the 
adjacent CP. 


APPC sends to the adjacent node a PIU with this CP's CP Capabilities data. 
The PIU also carries a request that TP services in the adjacent node attach its 
CP Capabilities TP. 


APPC receives from the adjacent node a PIU containing the adjacent CP's CP 
Capabilities. 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” CP-CP Session Flows 
Licensed Materials — Property of IBM 


21. APPC posts the APPCCMD CONTROL=RECEIVE,QUALIFY=SPEC macroin- 
struction complete. 


22. The Request CP Capabilities TP responds to the successful completion of the 
RECEIVE macroinstruction by sending to the CP an 
ACT_CP_CP_SESSION_REPLY, which contains both the contention winner 
CGID and the CP Capabilities data just received from the adjacent CP. 


23. The CP sends a CP_STATUS(ACTIVE,BOTH) signal to configuration services if 
both the contention winner and conloser CP-CP sessions are both active at this 
point. 


24. If both CPs are network nodes, a topology database update (TDU) will flow 
once the contention winner session is active. The TDU is used to update the 
partner regarding changes to network topology that have occurred since the 
two CPs were last in session. 


A TDU will also flow over the contention winner session from a VTAM end node 
to its network node server, if the network node server is a VTAM. This TDU 
carries information on changes that have occurred to the end node's con- 
nections since the end node and the network node server were last in session.. 
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Activating a CP-CP Conloser Session 


CP TP APPC SSCP BF 


(1) BIND 
(2)SCIP Exit 
(3) OPNSEC 

(4)RESP (BIND) 
(5) POST OPNSEC complete 


oe 


(6)PIU (Attach,CP Capabilities) 


(7)ATTACH_TP 


(8)RECEIVE, SPEC 


fe oe 


(9)Post RECEIVE,SPEC complete 


cosas 
<< 


11)CP_cP —| | ACT_REPLY 


FA SEND, DATA 
(13)PIU (CP Capabilities) 


= SEND,DATA complete 


fee FLUSH 


(16)POST DEALLOC,FLUSH complete 


Figure 186. CP-CP Conloser Session Activation 


1. The BIND for the conloser CP-CP session is received from the adjacent node. 
2. The BIND drives the SCIP exit routine. 


3. The SCIP exit causes APPC to issue an OPNSEC macroinstruction to establish 
a session between APPC (operating as the SLU) and the PLU that sent the 
BIND. 


4. Tne OPNSEC macroinstruction causes a BIND response to be sent to the adja- 
cent node. 


5. The OPNSEC is posted complete. 


6. APPC receives from the adjacent node a PIU containing the adjacent CP's CP 
Capabilities. The PIU also contains an FMH-5 specifying that the CP Capabili- 
ties Transaction Program (TP) is to be attached. 


7. APPC sends an ATTACH_TP AMU to TP Services to request the attachment of 
the CP Capabilities TP. 


8. After attachment, the CP Capabilities TP issues an APPCCMD 
CONTROL=RECEIVE,QUALIFY=SPEC instruction to receive the adjacent CP's 
CP Capabilities data. 


9. APPC posts the APPCCMD rele QUALIFY=SPEC macroin- 
struction complete. 
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10. The CP Capabilities TP builds and sends to the CP a CP_CP_SESSION_ACT 
signal, containing the conloser Conversation Group Identifier (CGID) and the 
adjacent CP's CP Capabilities data. 


11. The CP sends to the CP Capabilities TP a CP_CP_SESSION_ACT_REPLY. It 
contains the CP Capabilities of this node and also indicates whether or not 
SSC was able to successfully process the CONLOSER activation request. 


12. After receiving the CP_CP_SESSION_ACT_REPLY, the CP Capabilities TP 
issues an APPCCMD CONTROL=SEND,QUALIFY=DATA to send this CP's CP 
Capabilities to the adjacent CP. 


13. A PIU with this CP's CP Capabilities is transmitted to the adjacent CP. 


14. When the transmission is complete, the APPCCMD CONTROL=SEND, 
QUALIFY=DATA macroinstruction is posted complete by APPC. 


15. The CP Capabilities TP issues an APPCCMD CONTROL=DEALLOC, 
QUALIFY=FLUSH macroinstruction to flush the local LU's send buffer and deal- 
locate the conversation normally. 


16. APPC posts the APPCCMD CONTROL=DEALLOC,QUALIFY=FLUSH macroin- 
struction back upon completion. 
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Host CP Initiating Deactivation of CP-CP Session 


cP TP APPC SSCP BF 


| 
(1)DEACT_CP_CP_SESSION 
(2) REJECT, CONVGRP 


(3)CLSDST RELEASE 


(4) UNBIND 
(5)CP_CP_SESSION DEACT 


(6)CP_STATUS (INACTIVE) 


(7)RESP (UNBIND) 
(8)Post CLSDST complete 


— REJECT, CONVGRP complete 


Figure 187. Host CP Initiating Deactivation of CP-CP Session 


1. The CP sends a DEACT_CP_CP_SESSION to the 
SEND_REJECT_CONVGRP Transaction Program (TP). The CP sends this 
signal when it needs to have a particular CP-CP session with an adjacent node 
unbound. 


2. The SEND_REJECT_CONVGRP TP issues an APPCCMD 7 
CONTROL=REJECT, QUALIFY=CONVGRP macroinstruction to deactivate the 
specified session. 


3. APPC, responding to the APPCCMD 
CONTROL=REJECT,QUALIFY=CONVGRP macroinstruction, issues a CLSDST 
RELEASE macroinstruction to terminate the session. 


4. APPC also builds and sends a CP_CP_SESSION_DEACT for the specified 
session to the CP. This signal is sent by APPC to notify the CP that a CP-CP 
session outage is detected. It contains the session type and CGID of the 
CP-CP session that the outage is detected on. 


5. The CLSDST RELEASE causes SSCP to send an UNBIND for the particular 
session to the partner LU. 


6. The CP sends a CP_STATUS(INACTIVE) signal for the specified session to the 
SSCP. 


7. A response to the UNBIND is received by the SSCP from the partner LU. 


8. Having received the UNBIND response, the SSCP posts complete the CLSDST 
RELEASE. 


9. APPC posits the TP's APPCCMD CONTROL=REJECT,QUALIFY=CONVGRP 
macroinstruction complete. 
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Remote Node Initiating Deactivation of CP-CP Session 


CP APPC SSCP BF 


(1)UNBIND 


(2)SCIP Exit 


(3)RESP (UNBIND) 


(4)CP_CP_SESSION DEACT 


| 


(5)CP_STATUS (Inactive) 


Figure 188. Remote Node Initiating Deactivation of CP-CP Session 
1. An UNBIND is received from the adjacent node for a specific CP-CP session. 
The UNBIND carries a sense code associated with the session outage. 
2. The UNBIND drives the SCIP exit routine. 
3. The SSCP sends an UNBIND response to the adjacent node. 


4. APPC sends a CP_CP_SESSION_DEACT to the CP for the session specified 
in the UNBIND. The CP_CP_SESSION_DEACT carries the sense code ori- 
ginally carried by the UNBIND. 


5. The CP notifies the SSCP that the specified session is now inactive. 
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Activating a Leased APPN Node Type 2.1 


Operator's Communication 
Console SSCP Controller PU 


V NET,ACT,ID=PU name 
CONNOUT 
+RESP (CONNOUT) 
XID 
XID 
REQCONT 
+RESP (REQCONT) 
CONTACT 
+RESP(CONTACT) 
XID 
XID 


CONTACTED 


TDU (1) 


Figure 189. Activating a Leased APPN Node Type 2.1 


1. If this is a network node, a topology database update (TDV) is sent to all 
CP-CP session partners, informing them that this new APPN connection is 
available. If this is an end node, and the network node server is a VTAM, a 
TDU will be sent to the server, informing it of the new connection. 


Leased APPN PUs, as opposed to non-APPN PUs, have an additional CONNOUT, 
XID, and REQCONT flow. This flow allows transmission group oe negotiation 
during pre-negotiation XID exchanges. 
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Activating an APPN Host-to-Host Channel 


Hostl Host2 
Operator's Operator's 
Console SSCP PUNS TSC TSC PUNS SscP Console 


V NET,ACT, 


ID=PU1name 


V NET,ACT, 


ID=PU2name 


ACTLINK 
ACTLINK 


ACTLINK 


ACTLINK 


(ACTLINK) 


CONNOUT 


CONNOUT 


CONNOUT 


(CONNOUT) 


‘| CONNOUT 


REQCONT 
REQCONT 


REQCONT 


REQCONT 


CONTACT 


CONTACT 


CONTACT CONTACT 


CONTACTED 


CONTACTED 


CONTACTED 


Figure 190. Activating an APPN Host-to-Host Channel 
Note: XID2 Type 0 and Type 7 are sent across each subchannel associated with 


an APPN host-to-host channel connection. The XID3s are sent by choosing one of 
the available write subchannels for transmission. 
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Directory Services Flows 


To understand the following flows, it is helpful to understand the concept of 
resource registration and the implications of the values coded on the REGISTER 
operand. For information on resource registration and registering application pro- 
grams, see “Registering Resources” in VTAM Network Implementation Guide. For 
information about coding the REGISTER operand, see “Registering Application 
Programs’ in the VTAM Resource Definition Reference. 


In these directory services flows, assume the following, unless stated otherwise: 


e Sessions are initiated by the primary logical unit (PLU). 
e The flows illustrate search-only requests. 


index of Directory Services Flows 
Table 73 lists the directory services flows illustrated here. 


Table 73. Index of Directory Services Flows 
Flow Page 


Locate resource 


APPN and Subarea Network Figure 202 on page 1048 
APPN network, complex Figure 199 on page 1040 
Complex APPN network using more than one CDS | Figure 200 on page 1042 
CP-CP session terminates Figure 204 on page 1054 
CP network broadcast initiation Figure 197 on page 1037 
EN to NN Figure 193 on page 1032 
EN to NN to EN Figure 194 on page 1033 
EN to NN to NN to NN Figure 196 on page 1036 
EN to NN to subarea network Figure 198 on page 1039 
EN to NN to two ENs Figure 195 on page 1034 
NN receives network broadcast request Figure 205 on page 1055 
NNS of the OLU is at pre-V4R2 level Figure 201 on page 1045 
SLU-initiated session Figure 203 on page 1052 
Resource registration flows 

EN to NN to CDS ) Figure 191 on page 1029 
With error recovery Figure 192 on page 1031 
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Register Resource Flows 
Figure 191 and Figure 192 on page 1031 show the process of registering 
resources. : 


Resource Registration: EN to NN to CDS 


EN] NN1 CDS1 


SA APPN SA APPN SA APPN 
SSCP CP sscpP cP SSCP cP 


(1)REGISTER(LUA,LUB, LUC) 


(2) RESP(REGISTER) 


(3) LOCATE-REGISTER(LUA,LUB, LUC) 


(5)CRR_REQUEST (LUX, LUY, LUZ) 


(6)CRR_REQUEST 


(7) LOCATE-REGISTER(LUX, LUY, LUZ) 


= 


(16)DELETE Reply 


Figure 191. Resource Registration: EN to NN to CDS 


Note: In this figure, the end node registers its resources to NN1: 


e LUA 
e LUB 
e LUC. 


NN1 owns the following resources: 


e LUX 
e LUY 
e LUZ. 


NN1 registers the following resources to the central directory server (CDS): 


e LUA 
e LUB 
e LUC 
e LUX 
e LUY 
e LUZ. 


1. The VTAM operator in the end node activates a major node containing LUA, 
LUB, and LUC. The end node sends a registration request to NN1. 


2. NN1 adds entries to the directory database and then sends a registration reply 
to EN1. 
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3. NN1 sends a central registration request to CDS1. The registration request 
travels with a LOCATE GDS variable because the central directory server can 
be several nodes away. 


4. CDS1 returns a reply to NN1. 


5. The VTAM operator activates a major node containing applications X, Y, and Z. 
The subarea SSCP notifies the APPN control point (CP) of resources owned by 
NN1 that should be centrally registered. (CRR stands for central resource reg- 
istration.) 


. APPN CP sends an immediate reply to the subarea SSCP. 
. NN1 sends a central registration request to CDS1. 

. CDS1 returns a reply to NN1. 

. The end node sends a DELETE request to NN1. 


10. NN1 removes LUB from its directory database and returns a reply to the end 
node. NN1 does not forward the DELETE request to the central directory 
server. 


Oo OA N OO 
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Resource Registration with Error Recovery 


EN NN1 


SA APPN SA APPN 
SSCP cP SSCP cp 


(1) REGISTER(LUA,LUB, LUC) 


(2) REGISTER(CV'36',CV'37',LUB,LUC) 


(3) REGISTER(LUB, LUC) 


(4) RESP(REGISTER) 


Figure 192. Resource Registration with Error Recovery 


1. The VTAM operator in the end node activates a major node containing LUA, 
LUB, and LUC. The end node sends a registration request to NN1. 


2. The network node begins adding resources to its directory database. The 
network node successfully adds LUA. However, it encounters a problem and 
cannot continue adding resources to the directory database. The network node 
sends a negative reply to the end node to indicate which resource the network 
node was trying to add when it encountered the problem. The CV'36' indi- 
cates the sense code. The CV'37' indicates where the network node stopped 
adding to its directory database. 


3. The end node tries again to register those resources that were not successfully 
registered before. 


4. The network node successfully adds to the directory database and returns a 
reply. 
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Locate Resource Flows t | 
Figure 193 through Figure 205 on page 1055 show the search process. 


Locate Resource: EN to NN 


EN NN 


Subarea APPN APPN SA 
SSC cP SSCP 
SESS_REQ 


p cP 
SESS_REQ LOCATE-FIND—CDINIT 


SESS_REQ_COMP| LOCATE—FOUND-CDINIT | SESS_REQ_COMP 


Figure 193. Locate Resource: EN to NN 
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Locate Resource: 


Config: © —N——NN-——EN 


SESS_REQ 


SESS_REQ_COMP 


(1) LOCATE-FIND-CDINIT 
(2) LOCATE-FIND-CDINIT 
(3)SESS_REQ 


(5) LOCATE—FOUND-CDINIT 


(6) LOCATE—FOUND-CDINIT 


Directory Services: Locate Resource 


EN to NN to EN 


(4)SESS_REQ_COMP 


Figure 194. Locate Resource: EN to NN to EN 


Note: Nodes are connected by CP-CP sessions only. 


1. The end node sends a search request for a target resource to the network 
node server. As the network node server of the originating LU, NN1 looks for 
the target resource in the directory database. NN1 has knowledge in the direc- 
tory that the target resource resides on a served end node. 


2. NN1 sends a search request to the end node. 
3. The APPN control point (CP) sends a SESS_REQ signal to the SSCP. 
4. The SSCP sends a SESS_REQ_COMP signal to the APPN CP, indicating that 


the target resource is located. 


5. The end node sends a LOCATE reply to the network node server. 
6. NN1 sends a LOCATE reply to the end node. 
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Locate Resource: 


EN1 
Config: NAN] 
EN2 


EN NN EN1 EN2 


SESS_REQ_COMP 
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EN to NN to Two ENs 


APPN SA 
cP SSCP cP 


(1) LOCATE-FIND-CDINIT 


| | 
(2) CACHE_SEARCH 


- 


(3) CACHE_SEARCH_REPLY 


(4) CACHE_SEARCH 
a 
(5) CACHE_SEARCH_ REPLY 
(6) LOCATE-FIN 
(6) LOCATE—FIND+CDINIT 
(7) LOCATE(CV'35') 
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Figure 195. Locate Resource: EN to NN to Two ENs 


Note: Nodes are connected by CP-CP sessions only. 


Ve 


The end node sends a search request for a target resource to the network 
node server. The network node server looks for the target resource in the 
directory database. The end node that owns the resource did not register its 
resources. 


. The APPN control point (CP) requests that the subarea SSCP check for infor- 


mation about the location of the resource. 


3. The subarea SSCP replies that the target resource is not known. 


4. Because NN doesn't have the target resource in either its APPN or subarea 
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directories, it initiates a resource discovery search. The research discovery 
search starts at the beginning of the search logic with a “generic” request, 
which is not linked to the original OLU. Because the resource discovery search 
starts at the beginning of the search logic, another CACHE_SEARCH is per- 
formed. 


. The subarea SSCP replies that the target resource is not known. 


. The network node server performs a domain broadcast by sending the search 


request to all served end nodes that indicate on the CP_CAPABILITIES 
exchange that they are to be searched on domain broadcast. 
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7. Each end node that receives the request replies to the search request. EN1 
replies that the resource is not found. EN2 replies that it owns the resource. 


8. Because the resource discovery search found the resource, the NN sends a 
search to the target, containing the original session-specific information. 


9. The target is found. 


10. The network node server replies to the end node. 
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Locate Resource: EN to NN to NN to NN 
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Figure 196. Locate Resource: EN to NN to NN to NN 


Note: Nodes are connected by CP-CP sessions only. 


1. The end node sends a search request for a target resource to the network 
node server. The network node looks for the target resource in the directory 
database. The network node has knowledge in the directory that the target 
resource resides on NNS. 


2. The network node sends a directed search request to NN3. Because NN1 
does not have direct CP-CP sessions with NN3, NN1 sends the directed search 
request to NN3 through NN2. 


3. NN2 is not the destination of the directed search; therefore, NN2 simply for- 
wards the request to NN3. 


4. APPN control point (CP) sends a request for information to the subarea SSCP. 


5. The subarea SSCP replies that the target resource can be found in the subarea 
network. 


6. APPN control point (CP) sends a SESS_REQ signal to the subarea SSCP. 


7. The subarea SSCP sends a SESS_REQ_COMP signal to the APPN CP, indi- 
cating that the target resource is located. 


8. NN3 sends a LOCATE reply to NN2, which forwards the reply back to NN1. 
9. NN1 sends a LOCATE reply to the end node. © | 
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Locate Resource: CP Network Broadcast Initiation 


Config: NN1—NN2—NN3 


N4 


NN1 NN2 NN3 NN4 


SA APPN SA APPN SA APPN SA APPN 
SSCP cP SSCP cP SSCP cP SSCP CP 
(1)SESS_REQ 

(2) LOCATE-FINO-CDINIT 

(3) LOCATE-FIND-CDINIT 
(4) LOCATE(CV'35') 


(5) LOCATE (CV'35') 


SESS_REQ 


SESS_REQ_COMP 


(6) LOCATE-FOUND—CDINIT 


ae (7) LOCATE-FIND-CDINIT 


(8) LOCATE-FOUND-CDINIT ; 


SESS_REQ COMP 


Figure 197. Locate Resource: CP Network Broadcast Initiation 


1. A resource in NN1 requests a search for a resource on NN4. As network node 
server of the originating LU, NN1 looks for the target resource in the directory 
database. NN1 has no knowledge of the location of the target resource.. NN1 
initiates a resource discovery search for the target, which contains no session- 
specific information. 


2. NN1 has no APPN-domain end nodes, therefore no domain broadcast occurs. 
There is no central directory server in the network; therefore, NN1 sends a 
broadcast search request to every network node with which NN1 has CP-CP 
sessions. 


3. Each network node that receives the network broadcast request forwards the 
request to every network node with which it has CP-CP sessions. (It does not 
forward the request to the node from which it received the broadcast request.) 
Those nodes then begin searching their respective domains for the target 
resource. (For broadcast-specific flows for those nodes, see Figure 205 on 
page 1055.) 


4. NN2 searches its domain for the resource. (Flows are not shown; see 
Figure 205 on page 1055) NN2 does not locate the resource. However, NN2 
does not reply to NN1 until it has received a reply from all of the nodes to 
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which it forwarded the request. NN3 does not locate the resource in its own 
domain and replies to NN2. 


5. NN2 now returns a negative reply to NN1 because NN2 has exhausted its 
search logic. 


6. NN4 owns the resource; therefore, it returns a positive reply to NN1. 


7. Because the resource discovery search located the resource, NN1 sends a 
search to the target containing the original session-specific information. 


8. The target is found. 
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Figure 198. Locate Resource: EN to NN to Subarea Network 


1. The end node sends a search request for a target resource to the network 
node server. As network node server of the originating LU, NN1 looks for the 
target resource in the directory database. NN1 has no knowledge of the target 


resource in the directory database. 


. The APPN contro! point (CP) requests that the subarea SSCP check for infor- ~ : 
‘mation about the location of the resource. 


3. The subarea SSCP replies that an entry for the target resource is found. 


. The APPN CP requests that the subarea SSCP send the search request to the 
target resource. 


BAN 


. The request is sent to the owning SSCP. 
. The owning SSCP indicates that it owns the target resource. 


. The subarea SSCP replies to the APPN CP that the target resource is found. 


CoO N OO O 


. NN1 returns a positive reply to EN1. 
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Locate Resource: Complex APPN Network 
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Figure 199. Locate Resource: Complex APPN Network 


1. The end node sends a search request for a target resource to the network 
node server. As network node server of the originating LU, NN1 looks for the 
target resource in the directory database. NN1 has no knowledge of the target 
resource in the directory database. 


2. The APPN control point (CP) requests that the subarea SSCP check for infor- 
mation about the location of the resource. 


3. The subarea SSCP replies that the target resource is not known. 


4. Because NN1 doesn't have the target resource in either its APPN or subarea 
directories, it initiates a resource discovery search for the resource. Because 
the resource discovery search starts at the beginning of the search logic, 
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another CACHE_SEARCH is performed. NN1 has no APPN-domain ehd 
nodes; therefore, no domain broadcast occurs. 


5. The subarea SSCP replies that the target resource is not known. 


6. NN1 does not initiate a network broadcast because there is a central directory 
server (CDS) in the network; therefore, NN1 sends a request to this CDS. 


7. CDS1 receives the request and performs origin CDS logic. CDS1 looks in its 
directory database for the target resource and has an entry that indicates that 
the target resource resides on NN4. CDS1 sends the request to NN4. 


8. NN4 owns the resource; therefore, NN4 returns a positive reply. 
9. CDS1 replies to NN1. 


10. Because the resource discovery search found the resource, NN1 sends a 
search to the target, containing the original session-specific information. 


11. The target is found. 
12. NN1 replies to the end node. 
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Locate Resource: Complex APPN Network Using More Than 
One CDS | 
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Figure 200 (Part 1 of 2). Locate Resource: Complex APPN Network Using More Than 
One CDS 
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Figure 200 (Part 2 of 2). Locate Resource: Complex APPN Network Using More Than 
One CDS 


1. The end node sends a search request for a target resource to the network 
node server. As network node server of the originating LU, NN1 looks for the 
target resource in the directory database. NN1 has no knowledge of the target 
resource in the directory database. 


2. The APPN control point (CP) requests that the subarea SSCP check its 
resource information for information about the location of the resource. 


3. The subarea SSCP replies that the target resource is not known. 


4. Because NN1 doesn't have the target resource in either its APPN or subarea 
directories, it initiates a resource discovery search for the resource. Because 
the resource discovery search starts at the beginning of the search logic, 
another CACHE_SEARCH is performed. 


5. The subarea SSCP replies that the target resource is not known. 


6. NN1 has no APPN-domain end nodes; therefore, no domain broadcast occurs. 
NN1 does not initiate a network broadcast because there is a central directory 
server (CDS) in the network. NN1 sends a request to CDS1. 


7. CDS1 receives the request and performs origin CDS logic. CDS1 looks in its 
directory database for the target resource and does not have an entry. There- 
fore, the APPN control point (CP) requests the location of the resource from the 
subarea SSCP. 


8. The subarea SSCP replies that the target resource is not known. | 


9. CDS1 has no domain end nodes; therefore, no domain broadcast occurs. 
CDS1 begins an alternate CDS search by sending a request to CDS2. 


10. CDS2 looks in its directory database for the target resource and does not have 
an entry. The APPN CP requests that the subarea SSCP check for information 
about the location of the resource. 
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The subarea SSCP replies that the target resource is not known. 


CDS2 has no domain end nodes to which to send a domain broadcast. There- 
fore, CDS2 returns a negative reply to CDS1. 


CDS1 continues the alternate CDS search by sending a request to CDS3. 


CDS3 looks in its directory database and finds an entry that indicates that the 
target resource resides on NN3. CDS3 replies to CDS1 with this information. 


CDS1 sends a request to NN@ to verify that the target actually resides there. 
NN3 replies to CDS1 that it does, indeed, own the target resource. 
CDS1 returns a reply to NN1. 


Because the resource discovery search found the resource, NN1 sends a 
search to the target, containing the original session-specific information. 


The target is found. 


NN1 returns a reply to the end node. 
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Locate Resource: Network Node Server, NN1, of the Originating 
Logical Unit (OLU) is at Pre-V4R2 Level 
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Figure 201 (Part 1 of 2). Locate Resource: Network Node Server, NN1, of the Originating 
Logical Unit (OLU) is at Pre-V4R2 Level 
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CONFIG: EN--NNI—NN2—CDS1 
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Figure 201 (Part 2 of 2). Locate Resource: Network Node Server, NN1, of the Originating 
Logical Unit (OLU) is at Pre-V4R2 Level 


1. The end node sends a search request for a target resource to the network 
node server. As network node server of the originating LU, NN1 looks for the 
target resource in the directory database. NN1 has no knowledge of the target 
resource in the directory database. 


2. The APPN control point (CP) requests that the subarea SSCP check its 
resource information for the location of the resource. 


3. The subarea SSCP replies that the target resource is not known. NN1 has no 
APPN end nodes; therefore, no domain broadcast occurs. 


4. Because there is a central directory server (CDS) in the network, NN1 does not 
initiate a network broadcast. Instead, NN1 sends a request to CDS1. 


5. The CDS does not have knowledge of the target resource in its directory. The 
APPN control point (CP) requests that the subarea SSCP check its resource 
information for the location of the resource. 


6. The subarea SSCP replies that the target resource is not known. 


7. Because CDS1 does not have the target resource in either its APPN or 
subarea directories, it initiates a resource discovery search. Because the 
resource discovery search starts at the beginning of the search logic, another 
CACHE_SEARCH is performed. 


8. The subarea SSCP replies that the target resource is not known. 


9. CDS1 has no APPN end nodes; therefore, no domain broadcast occurs. CDS1 
initiates a network broadcast for the target resource. 


10. NN2 forwards the network broadcast request and then begins to search its 
domain. 


11. After completing its search logic, NN1 returns a negative reply to the network 
broadcast request. 


12. The subarea SSCP on NN2 indicates that the resource is found; therefore, a 
positive reply is returned. 
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13. Because the broadcast that was initiated by the resource discovery search 
found the resource, the original search request containing session-specific 
information is sent to the target's location, NN2. 


14. NN2, the owner of the resource, returns a positive reply. 


15. CDS1 replies to NN1, and NN1 replies to the end node. 
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Locate Resource: APPN and Subarea Network 


CONFIG: EN—NNI—CDS1—ICN2==Subarea Network==ICN3—NN4 
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Figure 202 (Part 1 of 3). Locate Resource: APPN and Subarea Network 
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CONFIG: EN—NN1—CDS1—ICN2==Subarea Network==ICN3—NN4 
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Figure 202 (Part 2 of 3). Locate Resource: APPN and Subarea Network 
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CONFIG: EN—NNI—CDS1—ICN2==Subarea Network==ICN3—TtNN4 
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Figure 202 (Part 3 of 3). Locate Resource: APPN and Subarea Network 


1. The end node sends a search request for a target resource to the network 
node server. As network node server of the originating LU, NN1 looks for the 
target resource in the directory database. NN1 has no knowledge of the target 
resource in the directory database. 


2. The APPN control point (CP) requests that the subarea SSCP check for infor- 
mation about the location of the resource. 


3. The subarea SSCP replies that the target resource is not Known. 


4. Because NN1 doesn't have the target resource in either its APPN or subarea 
directories, it initiates a resource discovery search for the resource. Because 
the resource discovery search starts at the beginning of the search logic, 
another CACHE_SEARCH is performed. 


5. The subarea SSCP replies that the target resource is not known. 


6. NN1 has no APPN-domain end nodes; therefore, no domain broadcast occurs. 
NN1 does not initiate a network broadcast because there is a central directory 
server (CDS) in the network; therefore, NN1 sends a request to CDS1. 


7. CDS1 receives the request and performs origin CDS logic. CDS1 looks in its 
directory database for the target resource and does not have an entry. There- 
fore, the APPN control point (CP) requests the location of the resource from the 
subarea SSCP. 


8. The subarea SSCP replies that the target resource is not known. 


9. CDS1 has no domain end nodes; therefore, no domain broadcast occurs. 
There are no other CDSs in the network; therefore, no alternate CDS search 
occurs. CDS1 initiates a network broadcast. CDS1 sends the broadcast 
request to all nodes with which it has CP-CP sessions. 


1050  VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” Directory Services: Locate Resource 
Licensed Materials — Property of IBM 


Notes: 


a. CDS1 must send the broadcast request to NN1, even though NN1 origi- 
nated the request to CDS1 because there can be parts of the APPN 
network that are reachable only through NN1 (these parts are not shown 
here). 


b. The network broadcast sent by a CDS indicates that attached subarea net- 
works should not be searched at this time. 


10. Both NN1 and ICN2 respond that the target is not found. 


11. After CDS1 has collected all the replies from the network broadcast, CDS1 con- 
tinues the search with an interchange node search. CDS1 sends the inter- 
change node search request to ICN2. This request indicates that the 
interchange node is to search its attached subarea network. | 


12. The APPN CP requests that the subarea SSCP initiate subarea routing. ICN2 
sends DSRLST to adjacent SSCPs. 


13. The subarea SSCP requests that the APPN CP initiate APPN searching. 


14. ICN3 looks for the target resource in the directory database. ICN3 has know- 
ledge in its directory database that the target resource resides in NN4. ICN3 
sends a directed search request to NN4. 


15. The APPN CP sends a SESS_REQ signal to the subarea SSCP. 


16. The subarea SSCP sends a SESS_REQ_COMP to the APPN CP indicating 
that the target resource is located. 


17. NN4 returns a positive reply to NN3. 

18. The APPN CP replies to the subarea SSCP. 
19. Positive responses to DSRLSTs are returned. 
20. The subarea SSCP replies to the APPN CP. 
21. ICN2 replies to CDS1. 

22. CDS1 replies to NN1. 


23. Because the resource discovery search located the resource, NN1 sends a 
search to the target, containing the original session-specific information. 


24. A DSRLST, which contains session-specific information, is sent. 


25. NN1 replies to the end node. 
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Locate Resource: SLU-initiated Session 
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(1) LOCATE—FIND-CDINIT 


(2) LOCATE—FIND—CDINIT 


(3) LOCATE—FIND~CDINIT 


(4) LOCATE-FIND-CDINIT 


(5)SESS_REQ 
(6)SESS_REQ 
(7) LOCATE-FIND—CDINIT 
(8) LOCATE-FOUND-CDINIT 


(9)SESS_REQ_COMP 


(10) SESS_REQ_COMP 


BIND 


(11) LOCATE—FOUND-CDINIT 
(12) LOCATE-FOUND-CDINIT 
(13) LOCATE-FOUND-CDINIT 
(14) LOCATE-FOUND-CDINIT 


(15)SESS_REQ_COMP 


Figure 203. Locate Resource: SLU-Initiated Session 


1. The end node sends a session request for a primary LU (PLU) to its network 
node server. NN1 looks for the PLU in its directory database. NN1 has know- 


ledge in the directory database that the PLU resides on EN2, which is served 
by NNS. 


2. The network node sends a directed search request to NN3. Because NN1 
does not have direct CP-CP sessions with NN3, NN1 sends the directed search 
request to NN3 through NN2. 


3. NN2 is not the destination of the directed search; therefore, NN2 simply for- 
wards the request to NNS3. 


4. NN receives the request and forwards it to EN2. 


5. The APPN CP sends a SESS_ REQ signal to the subarea SSCP. 
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6. The PLU initiates a search for the secondary LU (SLU), indicating that the 
location of the target does not have to be verified but that an RSCV must be 
calculated. 


7. The end node sends a search request for the SLU to its network node server. 


8. NN3 looks for the SLU in its directory database. NN3 has knowledge in its 
directory database that the SLU resides on EN1. Further, NN3 has information 
that allows the search to succeed without verifying the location of the SLU. On 
behalf of EN1, NN3 returns a positive reply, which includes the RSCV for the 
session. 


9. The APPN CP replies to the subarea SSCP for the PLU-initiated request. 


10. The subarea SSCP replies to the APPN CP for the SLU-initiated request, indi- 
cating that the session is already active. 


11. The end node sends a reply for the SLU-initiated request to NNS. 
12. NN3 replies to NN2. 

13. NN2 replies to NN1. 

14. NN1 replies to EN1. 

15. The APPN CP replies to the subarea SSCP. 
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Locate Resource: CP-CP Session Terminates 


CONFIG: EN1—NN1—NN2—NN3 


EN1 NN1 NN2 NN3 


SA APPN SA APPN SA APPN SA APPN 
sscpP cP SSCP cP =sscP cP = sscP cP 


- (1)SESS_REQ 


(2) LOCATE—FIND-CDINIT 


(3) LOCATE-FIND—CDINIT | 


(4) LOCATE—FIND—CDINIT 
a 
— 

—eE;" 
(8) XXXXXXXXXXXXXXX 


| 
(9) LOCATE (CV'35') (9)SESS_REQ_COMP 


(10)LOCATE(CV'35') 


Figure 204. Locate Resource: CP-CP Session Terminates 


1. The subarea SSCP requests a search for a target resource. 


2. The end node sends a Search request for a target resource to the network 
node server. The network node looks for the target resource in the directory 
database. The network node has knowledge in the directory that the target 
resource resides on NNS. 


3. The network node sends a directed search request to NN3. Because NN1_ 
does not have direct CP-CP sessions with NN3, NN1 sends the directed search 
request to NN3 through NN2. 


4. NN2 is not the destination of the directed search; therefore, NN2 simply for- 
wards the request to NN3. 


5. The APPN control point (CP) requests that the subarea SSCP check its 
resource information for information about the location of the resource. 


6. The subarea SSCP replies that the target resource is found. 


7. The APPN CP requests that the subarea SSCP initiate a search for the target 
resource. 


8. The CP-CP session goes down between NN2 and NNS. 
9. NN2 sends a negative reply to NN1. NNS3 cleans up its control blocks. 


10. NN1 continues its search logic. If another path to the target exists, the target 
can be found; for example, through a network broadcast search. Otherwise, 
the search does not find the target resource. 
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Locate Resource: Network Node Receives Network Broadcast 
Request 


CONFIG: CDS1—NN1—NN2 
EN1 


CDS1 NN1 EN1 NN2 


SA APPN SA APPN’ SA APPN SA APPN 
sscP cP SSCP CP SSCP CP SscpP cP 


(1) LOCATE—FIND-CDINIT 


(2) LOCATE-FIND-CDINIT 
(3) CACHE_SEARCH 
(4) CACHE_SEARCH_REPLY 


(5) LOCATE—FIND—CDINIT 


(6)SESS_REQ 
(7)SESS_REQ_COMP 
‘coe 


(9) LOCATE—FOUND—CDINIT 


(18) LOCATE (CV '35') 


(11) LOCATE 


Figure 205. Locate Resource: Network Node Receives Network Broadcast Request 


Note: This figure illustrates only the flows at NN1. 


1. CDS1 has reached the point in its search logic where a network broadcast is 
performed. CDS1 sends the network broadcast to all network nodes with which 
it has CP-CP sessions. 


2. NN1 recognizes that the request is a network broadcast. Therefore, it forwards 
the request immediately to all network nodes with which it has CP-CP sessions. 


3. NN1 then begins to search itself and its domain. NN1 looks for the target 
resource in its directory database. NN1 does not have an entry for the target 
resource. The search continues with the APPN CP requesting that the subarea 
SSCP check its resource information for information about the location of the 
resource. 


4. The subarea SSCP replies that the target is not known. 


5. NN1 sends the domain broadcast request to all served ENs that indicated in 
the CP_CAPABILITIES exchange that they are to be searched on domain 
broadcasts. 


. The APPN CP forwards the search to the subarea SSCP. 
. The subarea SSCP indicates that the target resource was found. 


. EN1 returns a positive reply. 


oO ON Oo 


. NN1 forwards the positive reply to CDS1 and continues to wait for a reply from 
NN2. NN1 indicates to CDS1 in its reply that NN1 has not yet received replies 
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to all of its searches. CDS1 forwards the positive reply to the originator of the 
search and continues to wait for a final reply from NN1. 


10. NN2 returns a negative reply to NN1. Because NN1 has now completed all of 
its searches, NN1 returns a Neutral reply to CDS1 to indicate that NN1 has 
completed its search. A Neutral reply is one that contains neither a CV'35' (to 
indicate failure) or a FOUND GDS variable (to indicate success). A CDS 
receiving a “neutral” reply does not forward the neutral reply to the originator of 
the search. A CDS returns only one reply to the originator to indicate success 
or failure. 
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LU-LU Session Flows 


Figure 206 on page 1059 through Figure 242 on page 1097 show the network 
flows to establish LU-LU sessions. 


The figure captions for some of the figures indicate the configuration that the flow 
applies to and the type of session shown. For example, the caption EN 
(PLU)-NNS...APPN Network; PLU-Initiated, with No Queueing means A primary 
logical unit (PLU) on an end node (EN) that is attached to an APPN network 
through a network node server (NNS). The symbol “—” indicates a CP-CP session. 
The symbol “==” indicates a CDRM-CDRM session. The symbol “...” means that 
part of the network is not shown. 


All of these flows assume that the directory services database has accurate infor- 
mation about the location of the destination LU. 


The following terms are used in these figures: 


Term Meaning 

Endpoint TGVs A list of control vector pairs: CV X'46' and X'47' 

RSCV Route selection control vector, CV X'2B' 

Scout search Sent to find out the location of the destination LU (DLU) and 


to precompute the session RSCV, if either the origin LU 
(OLU) or the DLU is in a subarea network. Because it is 
necessary only to find the DLU and not to set up the session, 
it is not necessary to actually verify the location of the DLU 
or to reserve resources for the session. 


Index of LU-LU Session Flows 
Table 74 lists the LU-LU session flows illustrated here. 


Table 74 (Page 1 of 2). Index of LU-LU Session Flows 


Flow Page 

APPN network...NNS--EN (PLU) 

SLU-initiated, no queueing Figure 213 on page 1066 
SLU-initiated, queued by the PLU Figure 214 on page 1067 
APPN network...NNS--EN (SLU) 

PLU-initiated, no queueing : Figure 211 on page 1064 
PLU-initiated, queued by the SLU Figure 212 on page 1065 


APPN network (PLU)...1ICN==SA(SLU), PLU-Initiated 
Directed search without required precompututed RSCV Figure 236 on page 1090 


No queueing Figure 235 on page 1089 
Queued by SLU Figure 238 on page 1092 
Search-only flow transformed into a DSRLST Figure 234 on page 1088 
USERVAR resolution required Figure 237 on page 1091 
APPN network (PLU)...ICN==VR-based TG==ICN...APPN 

network (SLU) 

PLU-initiated Figure 242 on page 1097 
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Flow 
‘APPN network (SLU)...1ICN==PLU 


Page 


Autologon, PLU not available initially Figure 241 on page 1096 
SLU-initiated, no queueing Figure 239 on page 1093 
SLU-initiated, queued by the PLU Figure 240 on page 1094 
CLSDST PASS; SLU is single-session capable 

From APPN to subarea Figure 231 on page 1085 
Through APPN Figure 230 on page 1084 
EN-NN-EN, PLU-initiated, no queueing (including BIND flows for Figure 232 on page 1086 
intermediate network node) 

EN (PLU)--NNS...APPN network 

PLU-initiated, no queueing Figure 206 on page 1059 
PLU-initiated, queued by the PLU Figure 207 on page 1060 
PLU-initiated, queued by the SLU Figure 208 on page 1061 
EN (SLU)--NNS...APPN network 

SLU-initiated, no queueing Figure 209 on page 1062 
SLU-initiated, queued by the PLU Figure 210 on page 1063 
intermediate Network Node (INN) BIND. The LOCATE did not go Figure 233 on page 1087 
through this node. 

SA (PLU)==ICN...APPN network (SLU) 

DSRLIST transforming into PLU-initiated, search-only Figure 215 on page 1068 
PLU-initiated, no queueing Figure 216 on page 1069 
PLU-initiated, queued by the SLU — Figure 218 on page 1071 
PLU-initiated, USERVAR resolution required Figure 217 on page 1070 
SA (SLU)==ICN....APPN network (PLU) 

Autologon, PLU not available initially Figure 221 on page 1076 
SLU-initiated, no queueing Figure 219 on page 1073 


SLU-initiated, queued by the PLU 


Figure 220 on page 1074 


Session release request 

_ SA(PLU)==ICN...APPN network(SLU) 
SA(SLU)==ICN...APPN network(PLU) 
Session termination, forced 


SA(PLU)==ICN...APPN Network(SLU), pending active session. 
PLU is accessible without going into APPN. 


SA(PLU)==ICN...APPN Network(SLU), queued session 


SA(PLU)==ICN...APPN Network(SLU), queued session. PLU is 
accessible without going into APPN. 


SA(SLU)==ICN...APPN Network(PLU), pending active session 
Session termination, orderly 

SA(PLU)==ICN...APPN Network(SLU), active session 

APPN Network(PLU)...1ICN==SA(SLU), active session 


Figure 228 on page 
Figure 229 on page 


Figure 225 on page 


Figure 226 on page 
Figure 227 on page 


Figure 224 on page 


Figure 222 on page 
Figure 223 on page 
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EN (PLU)--NNS...APPN Network, PLU-Initiated, with No Queueing 


EN NNS APPN network 
(PLU) (OLU) (SLU) 


LOCATE—FIND-CDINIT(OLU=PLU) 
LOCATE—FIND-CDINIT(OLU=PLU) 
LOCATE—FOUND-CDINIT( [ENDPOINT TGVS] ) 
LOCATE—FOUND-CDINIT(BIND RSCV) 

BIND 
RESP (BIND) 


LOCATE-CDINIT(SESSST) 
LOCATE-CDINIT(SESSST) 


Figure 206. EN (PLU)—NNS...APPN Network, PLU-Initiated, with No Queueing 


Note: The BIND does not have to take the same path as the LOCATE flow. 
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_ EN (PLU)--NNS...APPN Network, PLU-Initiated, Queued by the 


PLU 
EN NNS APPN network 
(PLU) (OLU) (SLU) 


LOCATE-FIND-CDINIT(OLU=PLU,Q-Only) 


LOCATE-FIND-CDINIT(OLU=PLU,Q—Only) 


LOCATE—FOUND—-CDINIT (QUEUVED) 


LOCATE—FOUND-CDINIT (QUEUED) 


LOCATE-CDINIT (DEQUEUE) 
hice Bienes 
LOCATE-CDINIT(PROCEED, [ENDPOINT TGVS] ) 
LOCATE-CDINIT(PROCEED,BIND RSCV) 
BIND 
RESP (BIND) 
LOCATE-CDINIT(SESSST) 


LOCATE-CDINIT(SESSST) 


Figure 207. EN (PLU)—NNS...APPN Network, PLU-Initiated, Queued by the PLU 


Note: The BIND does not have to take the same path as the LOCATE flow. 
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EN (PLU)--NNS...APPN Network, PLU-Initiated, Queued by the 


SLU 
EN NNS APPN network 
(PLU) (OLU) (SLU) 


LOCATE—-FIND-CDINIT(OLU=PLU) 
LOCATE—FIND-CDINIT(OLU=PLU) 
LOCATE—FOUND-CDINIT(QUEUED) 
LOCATE—FOUND-CDINIT(QUEUED) > 
LOCATE-CDINIT(DEQUEUE, [ENDPOINT TGVS] ) 
LOCATE-CDINIT(DEQUEUE,BIND RSCV) 
BIND 


RESP (BIND) 


LOCATE-CDINIT(SESSST) 
LOCATE—CDINIT(SESSST) 


Figure 208. EN (PLU)—NNS...APPN Network, PLU-Initiated, Queued by the SLU 


Note: The BIND does not have to take the same path as the LOCATE flow. 
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EN (SLU)--NNS...APPN Network, SLU-Initiated, with No Queueing 


EN NNS APPN network 
(SLU) (OLU) (PLU) 
LOCATE-FIND-CDINIT(DLU=PLU, Endpoint TGVs) 
LOCATE-FIND-CDINIT(DLU=PLU,Endpoint TGVs) 
BIND 
RESP (BIND) 


LOCATE—FOUND-CDINIT (SESSST) 


LOCATE—FOUND-CDINIT(SESSST) 


Figure 209. EN (SLU)—NNS...APPN Network, SLU-Initiated, with No Queueing 


Note: The BIND does not have to take the same path as the LOCATE flow. 
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EN (SLU)--NNS...APPN Network, SLU-Initiated, Queued by the 
PLU 


EN NNS APPN network 
SLU) (OLU) (PLU) 
LOCATE-FIND-CDINIT (DLU=PLU) 

LOCATE-FIND-CINIT (DLU=PLU) 

LOCATE-FOUND-CDINIT (QUEUED) 
LOCATE-FOUND—CDINIT (QUEUED) 

LOCATE—CDINIT (DEQUEUE) 
LOCATE-CDINIT (DEQUEUE) 

LOCATE-CDINIT (PROCEED) 

LOCATE-CDINIT(PROCEED, Endpoint TGVs) 
BIND 
+RESP (BIND) 
LOCATE-CDINIT(SESSST) 


LOCATE-CDINIT(SESSST) 


Figure 210. EN (SLU)—NNS...APPN Network, SLU-Initiated, Queued by the PLU 


Note: The BIND does not have to take the same path as the LOCATE flows. 
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APPN Network...NNS--EN (SLU), PLU-Initiated, No Queueing 


APPN APPN 
Network APPN EN 
(PLU) NN (SLU) 


LOCATE—FIND~CDINIT (OLU=PLU) 


LOCATE-FIND-CDINIT (OLU=PLU) 
LOCATE-FOUND—CDINIT (PROCEED, [ENDPOINT TGVs]) 
LOCATE-FOUND-CDINIT (PROCEED, ENDPOINT TGVs) 

BIND 
RESP (BIND) 
LOCATE-CDINIT(SESSST) 


LOCATE—CDINIT(SESSST) 


Figure 211. APPN Network...NNS—EN (SLU), PLU-Initiated, No Queueing 


Note: The BIND does not have to follow the same path as the LOCATE flow. 


1064  VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” LU-LU Session: APPN Network...NNS—EN (SLU) 
Licensed Materials — Property of IBM 


APPN Network...NNS--EN (SLU), PLU-Initiated, Queued by the 


APPN APPN 
Network APPN EN 
(PLU) NN (SLU) 


LOCATE-FIND-CDINIT (OLU=PLU) 
LOCATE-FIND-CDINIT (OLU=PLU) 
LOCATE—FOUND-CDINIT (QUEUED) 
LOCATE—FOUND-CDINIT (QUEUED) 
LOCATE-CDINIT(DEQUEUE, [ENDPOINT TGVs] ) 
LOCATE-CDINIT(DEQUEUE, ENDPOINT TGVs) 


BIND 
RESP (BIND) 
LOCATE-CDINIT(SESSST) 
LOCATE-CDINIT(SESSST) 


Figure 212. APPN Network...NNS—EN (SLU), PLU-Initiated, Queued by the SLU 


Note: The BIND does not have to follow the same path as the LOCATE flow. 
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APPN Network...NNS--EN (PLU), SLU-Initiated, No Queueing 


APPN APPN 
(SLU) NN (PLU) 


LOCATE-FIND—CDINIT(DLU=PLU) 


LOCATE—FIND-CDINIT (DLU=PLU) 


LOCATE-FIND-CDINIT(OLU=PLU) (1) 


LOCATE-FOUND-CDINIT(PROCEED RSCV) 


BIND (2) 
RESP (BIND) 


LOCATE-FOUND—CDINIT (DLU=PLU, SESSST) 


LOCATE-FOUND-CDINIT(DLU=PLU, SESSST) 


Figure 213. APPN Network...NNS—EN (PLU), SLU-Initiated, No Queueing 


1. The purpose of this search is to get the NN to compute the session RSCV for 
the EN. 


2. The BIND does not have to follow the same path as LOCATE flows. 
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LU-LU Session: APPN Network...NNS--EN (PLU) 


APPN Network...NNS--EN (PLU), SLU-Initiated, Queued by the 


PLU 

APPN 

Network APPN 
(SLU) NN 


LOCATE-FIND-CDINIT(DLU=PLU, [Endpoint TGVs]) 


LOCATE-FIND-CDINIT (DLU=PLU) 


LOCATE—FOUND-CDINIT (QUEUED) 


LOCATE-FOUND-CDINIT (QUEUED) 


LOCATE-CDINIT(DEQUEUE) (1) 


LOCATE—CDINIT (DEQUEUE) 


LOCATE—CDINIT(PROCEED[Endpoint TGVs] ) 


LOCATE-CDINIT(PROCEED RSCV) 


BIND (2) 


RESP(BIND) 


LOCATE-CDINIT(SESSST) 


LOCATE-CDINIT(SESSST) 


Figure 214. APPN Network...NNS—EN (PLU), SLU-Initiated, Queued by the PLU 


1. The PLU has become available. 


2. The BIND does not have to follow the same path as the LOCATE flows. 
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SA (PLU)==ICN...APPN Network (SLU), DSRLIST Transforming 
into PLU-Initiated, Search-Only 


Interchange Node 


Subarea Subarea BF APPN APPN 
Network SSCP SLU cP Network 
(PLU) (SLU) 
DSRLIST 


SESS_REQ(Search—Only) 


LOCATE-FIND-CDINIT(OLU=PLU) 


arenes 


LOCATE-FOUND-CDINIT(PROCEED) (1) 


SESS_REQ COMP (1) 


RESP (DSRLST) (1) 


Figure 215. SA(PLU)==ICN...APPN Network (SLU), 
DSRLIST Transforming into PLU-Initiated, Search-Only 


1. Target LU location information. 
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SA (PLU)==ICN...APPN Network (SLU), PLU-Initiated, with No 
Queueing 


Interchange Node 
Subarea Subarea BF APPN APPN 
Network SSCP SLU cP Network 
(PLU) (SLU) 


CDINIT 
SESS REQ (scout search) 
SESS REQ COMP (RSCV) 
RESP (RNAA) 
SESS REQ (OLU=PLU RSCV) 
LOCATE-FIND-CDINIT (OLU=PLU RSCV) 
LOCATE—FOUND—CDINIT (PROCEED) 
PROCEED 
RESP(CDINIT[RSCV] ) 
COCINIT 
RESP (CDCINIT) 
BIND [RSCV] 
BFINIT (1) 


BFCINIT(RSCV) | (1) 
RESP(BFCINIT) (1) 


BIND(RSCV) 
RESP (BIND) RESP(BIND(RSCV) ) 
BFSESSST 
CDSESSST 
RESP(CDSESSST) 


SESS_REQ_COMP 


LOCATE-CDINIT(SESSST) 


Figure 216. SA (PLU)==ICN...APPN Network (SLU), PLU-Initiated, with No Queueing 


1. These BFINIT/BFCINIT flows will not occur if the RSCV is passed on the BIND. 
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SA (PLU)==ICN...APPN Network (SLU), PLU-Initiated, USERVAR 
Resolution Required 


Interchange Node 
Subarea BF APPN 
SSCP SLU cp 


CDINIT or DSRLST (1) 


APPN 
Network 
(SLU) 


Subarea 
Network 
(PLU) 


SESS REQ (1) 
LOCATE-FIND-CDINIT (1) 

LOCATE-FOUND-CDINIT (2) 

Figure 217. SA (PLU)==ICN...APPN Network (SLU), PLU-Initiated, USERVAR Resolution 
Required 


SESS_REQ_COMP (2) 


CDTERM or RESP(DSRLST) (2) 


1. Generic USERVAR name. 
2. Resolved USERVAR name. 


Note: For remaining session setup flows, see Figure 216 on page 1069. 
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SA (PLU)==ICN...APPN Network (SLU), PLU-Initiated, Queued by 
the SLU 


Interchange Node 


Subarea APPN 
Network Network 
(PLU) (SLU) 


CDINIT 
SESS_REQ (scout search) 


SESS _REQ_COMP(RSCV) 


RESP (RNAA) 
SESS_REQ(OLU=PLU RSCV) 
LOCATE-FIND-CDINIT(OLU=PLU RSCV) 
LOCATE—FOUND-CDINIT ( QUEUED) 

QUEUED 
RESP(CDINIT) (QUEUED) 
LOCATE-CDINIT(DEQUEUE, [Endpoint TGVs]) 
DEQUEUE (RSCV) 


Figure 218 (Part 1 of 2). SA (PLU)==ICN...APPN Network (SLU), PLU-Initiated, Queued by 
the SLU 
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Subarea APPN 
Network Network 
(PLU) (SLU) 


CDINIT (DEQUEVE[RSCV]) (1) 


"  RESP(CDINIT) 
CDCINIT 
+ RESP(CDCINIT) 
BIND[RSCV] 
BFINIT (1) 
BFCINIT(RSCV) (1) 
RESP(BFCINIT) (1) 
BIND(RSCV) 
RESP (BIND) RESP(BIND(RSCV)) 
BFSESSST 
CDSESSST 
RESP (CDSESSST) 


SESS_REQ_COMP(SESSST) 


LOCATE—CDINIT(SESSST) 


Figure 218 (Part 2 of 2). SA (PLU)==ICN...APPN Network (SLU), PLU-Initiated, Queued by 
the SLU 


1. These BFINIT/BFCINIT flows will not occur if the RSCV is passed on the BIND. 
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LU-LU Session: SA (SLU)==ICN...APPN Network (PLU) 


SA (SLU)==ICN...APPN Network (PLU), SLU-Initiated, No 


Queueing 


Interchange Node 


Subarea APPN APPN 
Network SSCP PLU cp Network 
SLU) (PLU) 
CDINIT 
SESS_REQ (scout seach 
SESS_REQ_COMP(RSCV) 
RNAA 
RESP (RNAA) 
SESS_REQ(DLU=PLU RSCV) 
LOCATE-FIND-CDINIT(DLU=PLU RSCV) 
BIND(RSCV) 
BFINIT(RSCV) 
RESP(CDINIT) 
CDOCINIT 
RESP(CDCINIT) 
RESP (BFCINIT) 
BIND 
RESP (BIND) ee RESP (BIND(RSCV) ) 
BFSESSST 
LOCATE-CDINIT(SESSST) 
SESS_REQ_COMP 
CDSESSST 
RESP(CDSESSST) 


Figure 219. SA (SLU)==ICN...APPN Network (PLU), SLU-Initiated, No Queueing 
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SA (SLU)==ICN...APPN Network (PLU), SLU-Initiated, Queued by 
the PLU 


Interchange Node 


Subarea APPN 
Network Network 
(SLU) (PLU) 


SESS_REQ_COMP(RSCV) 
RNAA 
RESP(RNAA) 
SESS_REQ(DLU=PLU RSCV) 
LOCATE-FIND-CDINIT(DLU=PLU RSCV) 
LOCATE—FOUND—CDINIT (QUEUED) 
QUEUED 
RESP(CDINIT) 
LOCATE-CDINIT (DEQUEUE) 
DEQUEUE 


CDINIT (DEQUEUE) 


RESP (CDINIT(DEQUEUE) ) 
PROCEED 
LOCATE-CDINIT (PROCEED) 
BIND(RSCV) 


BFINIT(RSCV) 


RESP(CDCINIT) 


Figure 220 (Part 1 of 2). SA (SLU)==/CN...APPN Network (PLU), SLU-Initiated, Queued by 
the PLU 
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Interchange Node 


Subarea APPN 
Network Network 
SLU PLU 
RESP(BFCINIT) 
BIND 
RESP(BIND) a RESP(BIND(RSCV) ) 
BFSESSST 
LOCATE-CDINIT(SESSST) 
SESS_REQ_COMP 
CDSESSST 
RESP(CDSESSST) 


Figure 220 (Part 2 of 2). SA (SLU)==ICN...APPN Network (PLU), SLU-Initiated, Queued by 


the PLU 
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LU-LU Session: SA (SLU)==ICN...APPN Network (PLU) “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


SA (SLU)==ICN...APPN network (PLU), Autologon, PLU Not 
Available Initially 


Network 
Subarea Subarea BF APPN 
Network SSCP SLU cp Controlling 
SLU PLU 


| 


activate, logapp]=PLU 
—_> 


CDINIT 


SESS_REQ (scout search) 


SESS_REQ_COMP(RSCY) 


RNAA 


RESP(RNAA) 


SESS_REQ(DLU=PLU RSCV) 
LOCATE-FIND-CDINIT 
(DLU=PLU RSCV) 
LOCATE(CV35(X ' @BBAXxxxx ' ) )-FOUND-CDINIT 
SESS_REQ_COMP(X' @88Axxxx ') 
FNA 


RESP(FNA) 


CDTERM(X ' O88Axxxx '') 


LOCATE-FIND-NOTIFY 
resource enabled) (1) 


RESOURCE AVAILABLE 


LOCATE-—FOUND 


Figure 221. SA (SLU)==ICN...APPN network (PLU), Autologon, PLU not available initially 


1. The controlling PLU becomes available. 


2. Normal SLU-initiated flows continue from here. 
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SA(PLU)==ICN...APPN Network(SLU), Orderly Termination of 
Active Session 


Interchange Node 
Subarea BF APPN 
SSCP SLU cP 


existing active session 


Subarea 
Network 
PLU 


APPN 
Network 
SLU 


v net,term, type=cond 
+ 
LOCATE-FIND-NOTIFY (CDTERM-ORDERLY) (1) 
ORDERLY_SESS_TERM REQ 


CDTERM(ORDERLY) (2) 


RESP (CDTERM) 
ORDERLY_SESS_TERM REQ COMP 
LOCATE—FOUND 
UNBIND 
BFSESSEND 
CDSESSEND 
RESP(CDSESSEND) 


Figure 222. SA(PLU)==ICN...APPN Network(SLU), Orderly Termination of Active Session 


1. FQCPID of the session to be terminated. 
2. The CDTERM type depends on the V NET,TERM type. 
V NET,TERM type CDTERM type 


COND ORDERLY 
UNCOND FORCED 
FORCE CLEANUP 
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APPN Network(PLU)...1ICN==(SA)SLU, Orderly Termination of 
Active Session 


APPN Subarea 
Network APPN BF Subarea Network 
cP SLU SSCP 

PLU SLU 
existing active session el aa 


CDTERM(Orderly) 
ORDERLY SESS TERM_REQ 
LOCATE—FIND-NOTIFY (CDTERM—ORDERLY) 
LOCATE—FOUND 
ORDERLY _SESS_TERM_REQ_COMP 
RESP(CDTERM) 
UNBIND 
RESP (UNBIND) re 
BFSESSEND 
CDSESSEND 
+RESP(CDSESSEND) 


Figure 223. APPN Network(PLU)...ICN==(SA)SLU, Orderly Termination of Active Session 
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Licensed Materials — Property of IBM 


SA(SLU)==ICN...APPN Network(PLU), Forced Termination of 
Pending Active Session 


Suba 


Network 


SLU 


R 


Interchange Node 


rea 


ESP(CDTERM) (2) 


SESSION REQ_COMP(CDTERM PARAMETERS) 


CDTERM( CLEANUP) 


LOCATE-NOTIFY (CDTERM—CLEANUP) 


Figure 224. SA(SLU)==ICN...APPN Network(PLU), Forced Termination of Pending Active 


Session 
1. The CDTERM type depends on the V NET,TERM type. 
V NET,TERM type CDOTERM type 
COND ORDERLY 
UNCOND FORCED 
FORCE CLEANUP 


. APPN only has orderly and cleanup termination. Therefore, the forced termi- 


nation is promoted to cleanup when it crosses from subarea into APPN. 
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SA(PLU)==ICN...APPN Network(SLU), Forced Termination of 
Pending Active Session (PLU Accessible without Going into 
APPN) 


Interchange Node 
Subarea Subarea BF APPN APPN 
Network SSCP SLU cP Network 
PLU SLU 
existing pending active session a 
v net, term, type=uncond 
—— 
CDTERM(FORCED) 
RESP (CDTERM) 
UNBIND 
+RESP Pt 
BFSESSEND 
CDSESSEND 
+RESP 


Figure 225. SA(PLU)==ICN...APPN Network(SLU), Forced Termination of Pending Active 
Session (PLU Accessible without Going into APPN) 


Note: Whenever a forced termination crosses the boundary from subarea into 


APPN, it is promoted to cleanup. In this case because the PLU is accessible 
without going into the APPN network, promotion does not occur. 
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SA(PLU)==ICN...APPN Network(SLU), Forced Termination of 
Queued Session 


Interchange Node 
Subarea APPN 
SSCP if cp 


existing queued session 


Subarea 
Network 
PLU 


APPN 
Network 
SLU 


v net, term, type=uncond 


RESP(CDTERM) (2) 


SESSION _REQ_COMP(CDTERM parameters) 


seem cum 


Figure 226. SA(PLU)==ICN...APPN Network(SLU), Forced Termination of Queued Session 


COTERM(CLEANUP) 


1. The CDTERM type depends on the V NET,TERM type. 
V NET,TERM type CDTERM type 


COND ORDERLY 
UNCOND FORCED 
FORCE CLEANUP 


2. APPN only has orderly and cleanup termination. Therefore, the forced termi- 
nation is promoted to cleanup when it crosses from subarea into APPN. 
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SA(PLU)==ICN...APPN Network(SLU), Forced Termination of 
Queued Session (PLU Accessible without Going into APPN) 


Interchange Node 


Subarea 
Network 
PLU 


existing QUEUED session 


v net term,type=forced 
_———_—> 


CDTERM(CLEANUP) (1) 


SESSION _REQ_COMP(CDTERM parameters) 


seremigcom 


Figure 227. SA(PLU)==ICN...APPN Network(SLU), Forced Termination of Queued Session 
(PLU Accessible without Going into APPN) : 


1. Because the session is queued (instead of pending active) and the forced ter- 
mination is not issued in the primary LU's domain, a CLEANUP is sent. 
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SA (PLU)==ICN...APPN Network (SLU), Session Release Request 


Interchange Node 


Subarea APPN 
Network Network 
PLU SLU 


LOCATE—FIND-NOTIFY (RELREQ) 


SESS _REL_REQ 


NOTIFY (6) 


SESS_REL_REQ_COMP 


LOCATE—FOUND 


RESP(NOTIFY) 


Figure 228. SA (PLU)==ICN...APPN Network (SLU), Session Release Request 


SA (SLU)==ICN...APPN Network (PLU), Session Release Request 


Interchange Node 


Subarea APPN BF Subarea APPN 
Network cP SLU SSCP Network 
SLU PLU 


SESS_REL_REQ 


RESP(NOTIFY) 


LOCATE—FIND-NOTIFY (RELREQ) 


LOCATE-FOUND 


Figure 229. SA (SLU)==ICN...APPN Network (PLU), Session Release Request 
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LU-LU Session: CLSDST PASS “Restricted Materials of IBM” 
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CLSDST PASS through APPN 


Subarea Subarea APPN APPN APPN 
Network SSCP cP Network Network 


PLU SLU PLU 


CLSDST PASS 


INIT_OTHER_CD 


INIT_OTHER 
LOCATE-FIND-INIT_OTHER_ CD 
LOCATE-FIND-CDINIT(DLU=PLU, Q) 
LOCATE-FOUND—CDINIT (QUEUED) 
LOCATE-FOUND-INIT_OTHER_CD(QUEUED) 
QUEUED 


RESP(INIT_OTHER_CD) 


release existing session 


LOCATE-CDINIT (DEQUEUE) 


LOCATE-CDINIT (SESSST) 
LOCATE-INIT_OTHER_CD(SESSST) 
INIT_OTHER_COMP 


¢~_--_-__- 


NOTIFY (3) 


Figure 230. CLSDST PASS through APPN. The SLU is Single-Session Capable. 
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CLSDST PASS from APPN to Subarea 


Interchange Node 
APPN 


Network APPM BF Subarea Subarea 
Controlling cP SLU SSCP Network 
PLU SLU New PLU 


existing session 


CLSDST PASS 
> 


LOCATE—-FIND-INIT_OTHER_CD 


rs 
INIT_OTHER 
INIT_OTHER_CD 
SE Eee 
CDINIT(DLU=PLU,Q) 
ance 
RESP(CDINIT (QUEUED) ) 
aaa aoc 
RESP(INIT_OTHER_CD(QUEUED)) 
Sane 
QUEUED 


LOCATE—FOUND-INIT_OTHER_CD 


release existing session 


CDINIT(DEQUEUE) 


RESP(CDINIT) 


CDOCINIT 


RESP (CDCINIT) 


RESP(BIND) 


CDSESSST 


RESP(CDSESSST) 


NOTIFY(3) 


INIT_OTHER_COMP 


LOCATE-INIT_OTHER CD(SESSST) 


LU-LU Session: CLSDST PASS 


Figure 231. CLSDST PASS from APPN to Subarea. The SLU is single-session capable. 
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LU-LU Session: 


EN-NN-EN “Restricted Materials of IBM” 


Licensed Materials — Property of IBM 


EN-NN-EN, PLU-Initiated, No Queueing 


APPN Network Node 


APPN APPN BF Subarea APPN 
EN cP SLU or PLU SSCP EN 
PLU SLU 


LOCATE-FIND—CDINIT(OLU=PLU) 
LOCATE-FIND-CDINIT (OLU=PLU) 
LOCATE-FOUND-CDINIT(PROCEED[Endpoint TGVs] ) 
LOCATE-FOUND—-CDINIT(PROCEED, Bind RSCV) 
BIND(RSCV) 
BFINIT(RSCV) 
RNAA (1) 
RESP(RNAA) (1) 
RNAA (2) 
RESP(RNAA) (2) 
BFCINIT(RSCV) 
+RESP(BFCINIT) 
BIND(RSCV) 
BFSESSST (1) 
BFSESSST (2) 
LOCATE—CDINIT(SESSST) 
LOCATE-CDINIT(SESSST) 


Figure 232. EN-NN-EN, PLU-Initiated, No Queueing (Including BIND Flows for Intermediate 
Network Node) 


1. For the PLU side of the session. 


2. For the SLU side of the session. 
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Intermediate Network Node (INN) BIND 


APPN APPN BF Subarea APPN 
EN CP SLU or PLU SSCP EN 
PLU SLU 
BIND(RSCV) 
BFINIT(RSCV) 
RNAA (1) 
RESP(RNAA) (1) 


RNAA (2) 


RESP(RNAA) (2) 


BFCINIT(RSCV) 


BFSESSST (1) 


BFSESSST (2) 


Figure 233. Intermediate Network Node (INN) BIND. The LOCATE did not go through this 
node. 


1. For the PLU side of the session. 


2. For the SLU side of the session. 
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APPN Network (PLU)...ICN==SA(SLU), PLU-Initiated, Search-Only 
Flow Transformed into a DSRLST 


Interchange Node 
APPN BF Subarea 
Network cP PLU SScP 
PLU - 


Subarea 
Network 
SLU 


RESP(DSRLST) 


SESS_REQ_COMP(PROCEED) 


LOCATE-FOUND-CDINIT (PROCEED) 


Figure 234. APPN Network (PLU)...ICN==SA(SLU), PLU-Initiated, Search-Only Flow Trans- 
formed into a DSRLST | 
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APPN Network (PLU)...ICN==SA(SLU), PLU-Initiated, No 
Queueing 


Interchange Node 
APPN APPN BF Subarea Subarea 
Network cP PLU SSCP Network 
PLU SLU 
LOCATE-FIND-CDINIT(OLU=PLU RSCV) (1) 


SESS_REQ(RSCV) 


RNAA 
RESP(RNAA) 
CDINIT 
RESP (CDINIT) 
PROCEED 
LOCATE-FOUND-CDINIT (PROCEED) 
BIND (RSCV) 
BFINIT(RSCV) 
CDCINIT 
RESP(CDCINIT) 
BFCINIT(RSCV) 
RESP(BFCINIT) 
BIND 
RESP(BIND(RSCV)) 
BFSESSST 
LOCATE-CDINIT (SESSST) 
SESS_REQ_COMP(SESSST) 
CDSESSST 
RESP (CDSESSST) 


Figure 235. APPN Network (PLU)...ICN==SA(SLU), PLU-Initiated, No Queueing 


1. Because the DLU is in subarea, the NNS(OLU) precomputed the RSCV. 
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APPN Network (PLU)...ICN==SA(SLU), PLU-Initiated, Directed 
Search without Required Precomputed RSCV 


Interchange Node 


APPN APPN BF Subarea 
Network cP PLU Network 
PLU SLU 


LOCATE-FIND-CDINIT (OLU=PLU) 
SESS_REQ 


DSRLST (1) 


RESP(DSRLST) (1) 


SESS_REQ_COMP(Resubdir) (2) 


LOCATE(Resubdir)—FOUND-CDINIT (3) 


LOCATE-FIND-CDINIT(OLU=PLU RSCV) 


SESS_REQ(RSCV) 


RNAA 
RESP(RNAA) 
CDINIT 
RESP(CDINIT) 
PROCEED 
LOCATE—FOUND-CDINIT (PROCEED) 
BIND (RSCV) 
BFINIT(RSCV) 
CDCINIT 
RESP(CDCINIT) 
BFCINIT(RSCV) 
RESP(BFCINIT) 
BIND 
RESP(BIND(RSCV) ) RESP(BIND) 
BFSESSST 
LOCATE~CDINIT (SESSST) 
SESS_REQ_COMP(SESSST) 
CDSESSST 
RESP(CDSESSST) 


Figure 236. APPN Network (PLU)...ICN==SA(SLU), PLU-Initiated, Directed Search without 
Required Precomputed RSCV 


1. Optional; sent if owning CP is not known. 
2. Resubdir means "Resubmit Request on a Directed Search." 


3. The interchange node returns the fact that the SLU is in a subarea network and 
requires a precomputed RSCV. 
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APPN Network (PLU)...ICN==SA(SLU), PLU-Initiated, USERVAR 
Resolution Required 


Interchange Node 
APPN APPN BF Subarea 
Network cP PLU SSCP 


LOCATE-FIND-CDINIT(OLU=PLU) (1) 


Subarea 
Network 
SLU 


SESS REQ (1) 
CDINIT or DSRLST} (1) 

CDTERM or RESP(DSRLST) (2) 
SESS_REQ COMP (2) 
LOCATE-FOUND-CDINIT(PROCEED) (2) 


Figure 237. APPN Network (PLU)...ICN==SA(SLU), PLU-Initiated, USERVAR Resolution 
Required 


1. Generic USERVAR name 
2. Resolved USERVAR name 


For remaining session setup flows, see Figure 235 on page 1089. 
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APPN Network (PLU)...ICN==SA(SLU), PLU-Initiated, Queued by 
the SLU 


Interchange Node 
APPN APPN BF Subarea Subarea 
Network cP PLU sscp Network 
PLU SLU 
LOCATE—FIND-CDINIT(OLU=PLU RSCV) (1) 
SESS_REQ(RSCV) 


RNAA 


RESP (RNAA) 


CDINIT 


RESP(CDINIT, (QUEUED) ) 


QUEUED 


LOCATE—FOUND—CDINIT (QUEUED) 


CDINIT(DEQUEUE) 
DEQUEUE 
LOCATE—CDINIT (DEQUEUE) 
BIND(RSCV) 
RESP(CDINIT) 
CDCINIT 
RESP(CDCINIT) 
BFCINIT(RSCV) 
BIND 
RESP (BIND(RSCV)) 
BFSESSST 
LOCATE-CDINIT (SESSST) 
SESS_REQ_COMP(SESSST) 
CDSESSST 
RESP(CDSESSST) 


Figure 238. APPN Network (PLU)...ICN==SA(SLU), PLU-Initiated, Queued by the SLU 


1. Because the DLU is in subarea, the NNS(OLU) precomputed the RSCV. 
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APPN Network (SLU)...IC ==SA(PLU), SLU-Initiated, No 
Queueing 


Interchange Node 
APPN APPN BF Subarea Subarea 
Network cP SLU sscP Network 
SLU PLU 


LOCATE-FIND-CDINIT(DLU=PLU RSCV) (1) 
SESSION_REQ(RSCV) 


RNAA 
RESP(RNAA) 
COINIT 

RESP(CDINIT) 
CDCINIT[RSCV] (2) 
RESP(CDCINIT) 

BIND [RSCV] 

BFINIT (3) 

BFCINIT(RSCV) | (3) 

RESP(BFCINIT) | (3) 

BIND(RSCV) (4) 
a 


RESP(BIND(RSCV) ) RESP (BIND) 
BFSESSST 
CDSESSST 
SESSION_REQ_COMP(SESSST) 
RESP (CDSESSST) 


LOCATE-FOUND-CDINIT (SESSST) 


Figure 239. APPN Network (SLU)...ICN==SA(PLU), SLU-Initiated, No Queueing 


1. Because the DLU is in subarea, the NNS(OLU) precomputes the RSCV. 


2. If the adjacent SSCP toward the PLU is VTAM V4R1 or higher and has the 
same network identifier, the RSCV is passed on the CDCINIT. 


3. If the RSCV is passed on the CDCINIT, these flows will not occur. 
4. The BIND does not have to follow the same path as the LOCATE flows. 
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APPN Network (SLU)...ICN==SA(PLU), SLU-Initiated, Queued by 
the PLU 


Interchange Node 


APPN APPN BF Subarea 
Network cP SLU Network 
SLU PLU 
LOCATE-FIND-CDINIT(DLU=PLU RSCV) (1) 
SESSION_REQ(RSCV) 
RNAA 
RESP(RNAA) 
CDINIT 
RESP(CDINIT(QUEUED) ) 


QUEVED 


LOCATE-FOUND—CDINI T (QUEUED) 


CDINIT(DEQUEUE) 
DEQUEUE 
LOCATE-CDINIT (DEQUEUE) 
LOCATE-CDINIT(PROCEED) 
PROCEED 
RESP(CDINIT (DEQUEUE) ) 
CDCINIT[RSCV] (2) 
BIND[RSCV] 
BFINIT (3) 
> 
BFCINIT(RSCV) (3) 
gee ea 
RESP(BFCINIT) (3) 
BIND(RSCV) (4) 
RESP (BIND(RSCV) ) RESP(BIND) 


Figure 240 (Part 1 of 2). APPN Network (SLU)...ICN==SA(PLU), SLU-Initiated, Queued by 
the PLU 
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APPN 
Network 
SLU 


LOCATE-CDINIT(SESSST) 


Interchange Node 
APPN BF Subarea 
cP SLU SSCP 


SESSION _REQ_COMP(SESSST) 


LU-LU Session: APPN Network (SLU)...ICN==SA(PLU) 


Subarea 
Network 
PLU 


BFSESSST 


CDSESSST 


RESP(CDSESSST) 


Figure 240 (Part 2 of 2). APPN Network (SLU)...ICN==SA(PLU), SLU-Initiated, Queued by 


the PLU 


1. Because the DLU is in subarea, the NNS(OLU) precomputed the RSCV. 


2. If the adjacent SSCP into the subarea is VTAM V4R1 or higher and has the 
same network identifier, the RSCV is passed on the CDCINIT. 


3. If the RSCV is passed on the CDCINIT, these flows will not occur. 
4. The BIND does not have to follow the same path as the LOCATE flows. 
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APPN Network (SLU)...ICN==SA(PLU), Autologon (PLU Not 
Available Initially) 


: Interchange Node 
APPN APPN BF Subarea Subarea 
Network cP SLU SSCP Network 
SLU PLU 
activate, logapp]=PLU 
—_> 


LOCATE-FIND-CDINIT(DLU=PLU RSCV) (1) 


SESSION_REQ(RSCV) 


CDINIT 


CDTERM, sense=O88Axxxx (2) 


SESSION REQ_COMP(@88Axxxx) 


LOCATE (CV35 (O88Axxxx) )—FOUND-CDINIT 


NOTIFY(8) (3) 
+ 


RESOURCE_AVAILABLE 
RESP(NOTIFY) 
LOCATE—FIND-NOTIFY (4) 
LOCATE-FOUND 
LOCATE—FIND-CDINIT(DLU=PLU RSCV) 


Normal SLU-initiated flows continue from here. 


| 
Figure 241. APPN Network (SLU)...ICN==SA(PLU), Autologon (PLU Not Available Initially) 


1. Because the DLU is in subarea, the NNS(OLU) precomputed the session 
-RSCV. 

2. The PLU is not currently available 

3. Some time later, the PLU becomes available. 


4. Resource enabled. 
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APPN Network (PLU)...ICN==VR-based TG==ICN...APPN Network (SLU) 


APPN Subarea BF APPN Subarea BF APPN APPN 
Network SSCP PLU cP sscP SLU cP NETWORK 
(PLU) (SLU) 


| 
tl LOCATE-FIND-CDINIT(OLU=PLU) Ld LOCATE-FIND-CDINIT (OLU=PLU) 


LOCATE-FOUND-CDINIT (PROCEED) 
RESP(CDINIT(VRTG) ) 


RESP (BIND(RSCV) ) —_ RESP (BIND(RSCV)) 


fom bnoed i - 


Figure 242. APPN Network (PLU)...ICN==VR-Based TG==ICN...APPN Network (SLU), PLU-Initiated 


LOCATE-FIND-CDINIT(OLU=PLU) 


LOCATE-FOUND-CDINIT (PROCEED) 
BIND(RSCV) 


LOCATE-FOUND-CDINIT (PROCEED) 


BFINIT(RSCV) 


CDINIT(VRTG) 


RESP(RNAA) 


BFCZNIT(RSCV) 


RESP(BFCINIT) 
RESP(BIND(RSCV) ) 


BFSESSST 
COSESSST 
RESP (CDSESSST) 


LOCATE-CDINIT(SESSST) 
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Dependent LU Server Flows 


Figure 243 on page 1099 through Figure 263 on page 1123 illustrate the flow of 
requests and responses between dependent logical unit requestors and servers. 


Index of Dependent LU Server Flows 
Table 75 lists the dependent LU server flows illustrated here. 


Table 75. Index of Dependent LU Server Flows 


Singie Subnetwork Fiow Page 

Activating resources 

CPSVRMGR pipe activation, DLUR-Initiated Figure 243 on page 1099 
CPSVRMGR pipe activation, DLUS-initiated Figure 244 on page 1100 
Dependent LUs, dynamic registration and activation of Figure 246 on page 1102 
Dependent LUs, activation of pre-defined Figure 247 on page 1103 
Physical Unit (PU), dynamic activation of | Figure 245 on page 1101 
SSCP-PU session activation race Figure 248 on page 1104 
Deactivating resources 

CPSVRMGR pipe deactivation Figure 249 on page 1105 
Downstream PU outage Figure 250 on page 1106 
REQDISCONT (immediate) received from downstream PU | Figure 252 on page 1108 
REQDISCONT (normal) received from downstream PU Figure 251 on page 1107 
LU-LU sessions 

APPN PLU-initiated to a dependent SLU Figure 257 on page 1113 
Session termination, USS flows for Figure 260 on page 1116 
USS SLU-initiated to APPN PLU Figure 258 on page 1114 
USS SLU-initiated to subarea PLU Figure 259 on page 1115 
SSCP-PU, SSCP-LU session deactivation 

Forced Figure 254 on page 1110 
Norma! Figure 253 on page 1109 
With Giveback (ANS=CONT) Figure 256 on page 1112 
With Giveback (ANS=STOP) Figure 255 on page 1111 
Cross Subnetwork Flow Page | 
PLU-Initiated Session with DLUS and DLUR within Different Sub- Figure 261 on page 1118 
networks 


PLU-Initiated Session with DLUS and PLU in one Subnetwork and Figure 262 on page 1121 
DLUR in Another 


SLU-Initiated Session with DLUS and DLUR within Different Sub- Figure 263 on page 1123 
networks 


1098 VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” Dependent LU Server: Single Subnetwork 
Licensed Materials — Property of IBM 


Single Subnetwork Flows 
Figure 243 through Figure 260 on page 1116 show the flow of requests and 
responses between dependent logical unit requestors and servers within a single 
subnetwork. 


DLUR-Initiated CPSVRMGR Pipe Activation 


DLUR NNS DLUS 
EN1 NN1 NN2 NCP sscp VTAM 


LOCATE(FIND) , CDINIT(MODE=CPSVRMGR) ) 
LOCATE(FIND) 


LOCATE (FOUND) 


ee ee 
BIND (MODE=CPSVRMGR) 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,REQACTPU) ,XID,PU TG,DL CAP,FQPCID) 


REQACTPU,XID,PU TG,DL CAP,FQPCID 
———~| 
+RESP(REQACTPU) ,DL CAP,FQPCID 


a ee Sa 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


LOCATE (FIND) 


LOCATE (FOUND) 


FID2 ENCAP((TH,RH,RESP(REQACTPU)) ,DL CAP,FQPCID 


ACTPU(PU NAME) ,EN1,PU TG,PU CHAR,FQPCID 
ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,ACTPU(PU NAME)),PU TG,PU CHAR,FQPCID) a 


ACTPU 


+RESP(ACTPU) 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,RESP(ACTPU) ) FQPCID) be teen 


+RESP(ACTPU) , FQPCID 


J 


Figure 243. DLUR-Initiated CPSVRMGR Pipe Activation 


1. XID flows as a result of a set normal response mode (SNRM) RU, an external 
command, or an internal activation signal. 
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DLUS-Initiated CPSVRMGR Pipe Activation 


DLUR NNS 


DLUS 
PUL EN1 NN1 NN2 NCP 


sscP VTAM 


ACTPU(PU NAME) ,E—N1,PU TG, 
PU CHAR,DL CAP,FQPCID 


LOCATE (FIND) ,CDINIT(MODE=CPSVRMGR) ) 


wocarecrmoy] TT 
ewnocmooencesvraed || 


~TAcTPU 


+RESP(ACTPU) 


LOCATE (FOUND) ,CDINIT(RSCV) ) 
BIND (MODE=CPSVRMGR) 


ATTACH(RECEIVE_ENCAP_MSG_TP) Ll 


FID2 ENCAP((TH,RH,RESP(ACTPU)) ,XID,DL CAP, FQPCID) 


+RESP(ACTPU) ,XID,DL CAP,FQPCID 


Figure 244. DLUS-Initiated CPSVRMGR Pipe Activation 
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Dynamic PU Activation 


DLUR NNS DLUS 
EN1 NN1 NN2 NCP SSCP VTAM 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,REQACTPU) ,XID,PU TG,FQPCID) 
REQACTPU,XID,PU TG,FQPCID 
+RESP(REQACTPU) , FQPCID 

ATTACH(RECEIVE_ENCAP_MSG TP) 

FID2 ENCAP((TH,RH,+RESP(REQACTPU) ) ,FQPCID) 


ACTPU(PU NAME),EN1,PU TG, 
PU CHAR, FQPCID 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,ACTPU(PU NAME)),PU TG,PU CHAR,FQPCID) as. 


ACTPU 


+RESP (ACTPU) 


ATTACH(RECEIVE_ENCAP_MSG_ TP) 


FID2 ENCAP((TH,RH,RESP(ACTPU) ) ,FQPCID) Pe nl 


+RESP(ACTPU) , FQPCID 


a 


Figure 245. Dynamic PU Activation 


1. XID flows as a result of a set normal response mode (SNRM) RU, an external 
command, or an internal activation signal. 
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Dynamic Registration and Activation of Dependent LUs 


SLU DLUR NNS DLUS 
LU1 PU1 EN1 NN1 NN2 NCP SSCP VTAM 
NMVT(PSID) 
ATTACH(RECEIVE_ENCAP_MSG_TP) 
Fie we masa) ec) | 
NMVT(PSID) ,FQPCID 


ACTLU(LU NAME), 
LU CHAR, FQPCID 


ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,ACTLU(LU NAME)),LU CHAR,FQPCID) 


ACTLU 


+RESP(ACTLU) 
ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,RESP{ACTLU) ) , FQPCID) Rees 


+RESP(ACTLU) ,FQPCID 


Figure 246. Dynamic Registration and Activation of Dependent LUs 


1102 VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” Dependent LU Server: Single Subnetwork 
Licensed Materials — Property of IBM 


Activation of Pre-Defined Dependent LUs 


SLU DLUR NNS DLUS 
LU1 PUI EN1 NN1 NN2 NCP SSCP VTAM 


+RESP(ACTPU) ,XID, FQPCID 


ACTLU(LU NAME), 
LU CHAR, FQPCID 


ATTACH (RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,ACTLU(LU NAME)),LU CHAR, FQPCID) Ew 


ACTLU 
+RESP(ACTLU) 
ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,RESP(ACTLU) ) ,FQPCID) aa: 


+RESP(ACTLU) , FQPCID 


Figure 247. Activation of Pre-Defined Dependent LUs 
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SSCP-PU Session Activation Race 


EN1 NN1 NN2 NCP SSCP VTAM 


Existing CPSVRMGR pipe 


ATTACH(RECEIVE_ENCAP_MSG_TP) - 


FID2 ENCAP((TH,RH,REQACTPU) ,XID,PU TG,FQPCID1) 


ACTPU(PU NAME) ,EN1, 
PU TG,PU CHAR, FQPCID2 


ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,ACTPU(PU NAME)),PU TG,PU CHAR,FQPCID2) 
REQACTPU,XID,PU TG,FQPCID1 
~RESP(REQACTPU) (sense code 08520002) ,FQPCID1 


ATTACH (RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,-RESP(REQACTPU) ) (sense code 68520002) , FQPCID1) 


ATTACH (RECEIVE_ENCAP_MSG_TP) | 


FID2 ENCAP((TH,RH,RESP(ACTPU)) ,FQPCID) Fo ee! 


+RESP(ACTPU) ,XID, FQPCID2 


Figure 248. SSCP-PU Session Activation Race 


1. XID flows as a result of a set normal response mode (SNRM) RU, an external 
command, or an internal activation signal. — 
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CPSVRMGR Pipe Deactivation 


DLUR NNS DLUS 
PU1 EN1 NN1 NN2 NCP SSCP VTAM 


Existing CPSVRMGR pipe 


Existing SSCP-PU session 
+» 


DACTPU, FQPCID 
ATTACH (RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,DACTPU) , FQPCID) aia ae 


DACTPU 


+RESP(DACTPU) 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,RESP(DACTPU) ) , FQPCID) ai 


+RESP(DACTPU) , FQPCID 
UNBIND(CONWINNER) 


UNBIND(CONLOSER) ae ie ee 
+RESP(UNBIND (CONLOSER) ) a Saae 


Figure 249. CPSVRMGR Pipe Deactivation 
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Downstream PU Outage 


DLUR NNS DLUS 
PU1 EN1 NN1 NN2 NCP SSCP VTAM 


Existing CPSVRMGR pipe 


Existing SSCP-PU session 
+> 


(Outage detected) 
ATTACH(RECEIVE_ENCAP_MSG_TP) 
ie ewer aconer} ecto) [ 
REQDACTPU, FQPCID 
+RESP(REQDACTPU) , FQPCID 
ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,RESP(REQDACTPU) ) ,FQPCID) aa 
DACTPU,FQPCID 


ATTACH(RECEIVE_ENCAP_MSG_TP) _ 


FID2 ENCAP((TH,RH,DACTPU) ,FQPCID) 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,RESP(DACTPU) ) ,FQPCID) 4 


+RESP(DACTPU) ,FQPCID 


UNBIND (CONWINNER) 


Figure 250. Downstream PU Outage 
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Receipt of REQDISCONT (Normal) from Downstream PU 


SLU DLUR NNS DLUS 
LU1 PUl EN1 NN1 NN2 NCP SSCP VTAM 


Existing CPSVRMGR pipe 


Existing SSCP-PU & SSCP-LU sessions 
{—______-—_> 


REQDISCONT (norma?) 


ATTACH(RECEIVE_ENCAP_MSG TP) 


FID2 ENCAP((TH,RH,REQDACTPU) ,FQPCID) 


pounce FQPCIO 
See EaETN: FQPCID 
ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,RESP(REQDACTPU) ) ,FQPCID) 
baci FQPCID 


ATTACH(RECEIVE_ENCAP_MSG_ TP) 
FID2 ENCAP((TH,RH,DACTLU) ,FQPCID) 


ATTACH(RECEIVE_ENCAP_MSG TP) a 


+RESP(DACTLU) 


FID2 ENCAP((TH,RH,RESP(DACTLU) ) ,FQPCID) 


+RESP(DACTLU) , FQPCID 
DACTPU, FQPCID 
ATTACH(RECEIVE_ENCAP_MSG_TP 

FID2 ENCAP((TH,RH,DACTPU) , FQPCID) 

DACTPU 


+RESP (DACTPU) 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,RESP(DACTLU) ) ,FQPCID) ae 


DLC DEACTIVATION 
+RESP(DACTPU) , FQPCID 
UNBIND(conwinner) 


eenlmnie (etree) fa 
+RESP(UNBIND(conloser) ) es i 


Figure 251. Receipt of REQDISCONT (Normal) from Downstream PU 
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Receipt of REQDISCONT (Immediate) from Downstream PU 


SLU DLUR NNS DLUS 
LU1 PUI EN1 NN1 NN2 ; NCP SSCP VTAM 


Existing CPSVRMGR pipe 


Existing SSCP-PU 
& il ose LU sessions 


REQDISCONT (Immediate) 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,REQDACTPU) ,FQPCID) aie 


plisasaateiah FQPCID 


Seo OT FQPCID 
ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP( (TH, RH ,RESP(REQDACTPU) ) , FQPCID) 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


DACTPU, — 


T= ae 
UNBIND(contoser en Pee eee 
mn aileg th) 


FID2 ENCAP((TH,RH,DACTPU) ,FQPCID) 


DACTPU 


UNBIND(conwinner) 


DLC deactivation 
+RESP(UNBIND(conwinner) ) 
}+RESP(UNBIND(conloser)) | 


Figure 252. Receipt of REQDISCONT (immediate) from Downstream PU 
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Normal SSCP-PU/SSCP-LU Session Deactivation 


SLU DLUR NNS DLUS NNS 


om 


Existing CPSVRMGR pipe 


Existing}/SSCP-LU session 
cana (ee 
Existing|SSCP-PU session 
_—> 

LU-LU session deactivation 


DACTLU, FQPCID 
ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,DACTLU) , FQPCID) 
DACTLU 
+RESP(DACTLU) 


ATTACH(RECEIVE_ENCAP_MSG_TP=X) 
FID2 ENCAP((TH,RH,RESP(DACTLU) ) ,FQPCID) 
+RESP(DACTLU) , FQPCID 


DACTPU, FQPCID 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,DACTPU) , FQPCID) 


ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,RESP(DACTPU) ) , FQPCID) 
+RESP(DACTPU) , FQPCID 


DLC Deactivation 


Figure 253. Normal SSCP-PU/SSCP-LU Session Deactivation 
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Forced SSCP-PU/SSCP-LU Session Deactivation 


SLU DLUR NNS DLUS NNS PLU 
LU1 PUL EN1 NN1 NN2 NCP) = SSCP 1 VTAM SSCP2 = NN3 EN2 ~~ LU2 


Existing} CPSVRMGR pipe 
Existing LU-LU Session 


Existing|SSCP-LU session 
+———_> 


DACTLU 
+RESP 
Existing/SSCP-PU session 


+> 


DACTPU, FQPCID 


ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,DACTPU) , FQPCID) 
+RESP(DACTPU) ,FQPCID 
DACTPU 
+RESP 
ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,RESP(DACTPU)) ,FQPCID) 
DLC DEACTIVATION 


Session Outage Notification 


Figure 254. Forced SSCP-PU/SSCP-LU Session Deactivation 
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Giveback SSCP-PU/SSCP-LU Session Deactivation (ANS=STOP) 


SLU DLUR NNS DLUS NNS PLU 
LU1 PU1 EN1 NN1 NN2 NCP SSCP1 VTAM SSCP2 NN3 EN2 LU2 


| 
Existing CPSVRMGR pipe 
Existing LU-LU session 


Existing|SSCP-LU session 
+> 


Existing|SSCP-PU session 
+ 


DACTPU(GIVEBACK) , FQPCID 
ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,DACTPU(GIVEBACK) ) , FQPCID) 
DACTPU 
+RESP (DACTPU) 
ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,RESP(DACTPU) ) ,FQPCID) 
+RESP(DACTPU) , FQPCID 
DLC Deactivation 


Session Outage Notification 


Figure 255. Giveback SSCP-PU/SSCP-LU Session Deactivation (ANS=STOP) 
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Giveback SSCP-PU/SSCP-LU Session Deactivation (ANS=CONT) 


SLU 
LUI 


SSCP-LU data 


DLUR NNS DLUS NNS PLU 
EN1 NN1 NN2 NCP SSCP1 VTAM SSCP2 NN3 EN2 Lu2 


Existing CPSVRMGR pipe 
Existing LU-LU session 


Existing}SSCP-LU session 
+___»> 


Existing|SSCP-PU session 
+> 


DACTPU(GIVEBACK) , FQPCID 
ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,DACTPU(GIVEBACK) ) ,FQPCID) 
ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,RESP(DACTPU) ) ,FQPCID) 
+RESP(DACTPU) , FQPCID 


-RESP(sense code 08570003) 


SSCP-PU data 


-RESP(sense code 087C6000) 


Figure 256. Giveback SSCP-PU/SSCP-LU Session Deactivation (ANS=CONT) 
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Dependent LU Server: Single Subnetwork 


APPN PLU-Initiated LU-LU Session to a Dependent SLU 


SLU DLUR 
LUI PUL EN1 
BIND 


+RESP (BIND) 


NNS 
NN1 NN2 NCP SSCP 1 


DLUS 

VTAM = NN3 NN4 EN2 LU2 
INIT 

LOCATE (REQ, DLU=SLU) CDINIT(1/Q) 

SLU on node EN1 (internal flow) 


LOCATE(REP,NNS(DLU) =VTAM, CP(DLU) =EN1, TGVs) 
CDINIT( PROCEED) 


LOCATE ,CDINIT(RSCV) 
CINIT 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,SESSST) , FQPCID) 


SESSST, FQPCID 
BFSESSST 
SESSST 
LOCATE (DISCARD, SESSST) 


SESSST 


Figure 257. APPN PLU-Initiated LU-LU Session to a Dependent SLU 


Note: The transmission group (TG) vectors of the end node dependent LU 
requestor are provided by previous TG vector registration over the CPSVRMGR 


pipe. 
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USS SLU-Initiated LU-LU Session to APPN PLU 


SLU DLUR NNS DLUS NNS PLU 
LU1 PU1 EN] NN1 NN2 NCP = SSCP1 VTAM = NN3 NN4 EN2 Lu2 


Session Request/CDINIT (internal flow) 


LOCATE (FIND(PLU,NNS (OLU) =VTAM,CP(OLU)=EN1) ) 
CDINIT(SLU_INIT,EN1 TGVs) 


S 
LOCATE(PLU) , CDINIT(RSCV) 
COINIT 
BIND 
A 
ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,SESSST) ,FQPCID) 
SESSST,FQPCID 
BFSESSST 
SESSST 
LOCATE (DISCARD ,SESSST) 


SESSST 


Figure 258. USS SLU-Initiated LU-LU Session to APPN PLU 


Note: The transmission group (TG) vectors of the end node dependent LU 
requestor are provided by previous TG vector registration over the CPSVRMGR 


pipe. 
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USS SLU-Initiated LU-LU Session to Subarea PLU 


SLU DLUR NNS DLUS 
LU1 PU1 EN1 NN1 NN2 NCP SSCP1 VTAM SSCP2 SSCP3 PLU 
LOGON PLU 


ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,RU(LOGON PLU)),FQPCID) 
LOGON PLU,FQPCID 
+RESP,FQPCID 
ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,RU(+RESP) ) , FQPCID) 
+RESP (LOGON) 
RNAA(SLU, LOCADDR=6) 
+RESP(RNAA) (xxx) 
CDINIT(OLUADDR=xxx) 
+RESP(CDINIT) 
USS MSG 6,FQPCID 
ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,RU(USS MSG @)) ,FQPCID) 


USS MSG 6 
CDCINIT 


+RESP(USS MSG 0) 
ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,RU(USS MSG @) (+RESP) ) , FQPCID) 


CINIT 
+RESP(USS MSG 0)FQPCID 
+RESP(CDCINIT) 


+RESP(CINIT) 
BIND(DAF=xxx) 


BFINIT(REQUEST_RSCV) 
BFINIT(RSCV) 


BIND(RSCV) 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,SESSST) , FQPCID) 
SESSST, FQPCID 
BFSESSST 
SESSST 
CDSESSST 
+RESP (CDSESSST) 


Figure 259. USS SLU-Initiated LU-LU Session to Subarea PLU 
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ae 


USS Flows for LU-LU Session Termination 


SLU DLUR NNS DLUS NNS PLU 
LU1 PU1 EN1 NN1 NN2 NCP SSCP1 VTAM =NN3 NN4 EN2 LU2 
LOGOFF 


ATTACH (RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH,RU(LOGOFF) ) ,FQPCID) 


LOGOFF ,FQPCID 
CDTERM | 
LOCATE(REQ,PCIDa,M1) ,NOTIFY (CDTERM, PCIDx) 
CTERM | 
Termschd 
Ged | ees Weta henen' SexRDT 
UNBIND(PCIDx, NORMAL) re ae 


+RESP(UNBIND) 


USS MSG 10 


ATTACH(RECEIVE_ENCAP_MSG_TP) 


FID2 ENCAP((TH,RH, SESSEND) ,FQPCID) 
SESSEND 
SESSEND, FQPCID 
USS MSG @,FQPCID 
BFSESSEND 
ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,RU(MSG10)) ,FQPCID) 


+RESP(USS MSG 16) 


ATTACH(RECEIVE_ENCAP_MSG_TP) 
FID2 ENCAP((TH,RH,RU(+RESP) ) ,FQPCID) 
+RESP, FQPCID 


Figure 260. USS Flows for LU-LU Session Termination 


Note: The transmission group (TG) vectors of the end node dependent LU 
-requestor are provided by previous TG vector registration over the CPSVRMGR 


pipe. 
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Cross Subnetwork Flows 


Figure 261 on page 1118 through Figure 263 on page 1123 show the flow of 
requests and responses between dependent logical unit requestors and servers 
across subnetworks. . 


Several abbreviations are used in these flow diagrams. 


DSL DLUS-served LU 
DSR DLUR search required 
ISB Internet search bit 
OCR Owning CP respond 
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PLU-Initiated Session with DLUS and DLUR within Different 
Subnetworks, PLU Is Through the Subarea 
NETA SUBAREA NETD 


NETC 
DLUS BN ICN BN BN PLU 
VTAM1 BNa ICNb BNc BNd NNb 
| 


(1) Locate(Req,Fa,M1,P1,-7DSR), 
Find(SLU,-~DSL,-0CR) 
+. 
CDINIT(1/Q) 


NETB 


BN DLUR 
BNb NNa 


| 
Locate(Req,Fa,M2,P1,-DSR), 
Find(SLU,-DSL,-DSR) 
-—_—_———_—_———O 


CDINIT(1/Q) 


Locate(Req,Fa,M3,P1,-DSR), 
Find(SLU,~DSL,-OCR) 


| | | CDINIT(I/Q) 
Locate(Req,Fa,M4,P1,-DSR) ,Find(SLU,-DSL,-OCR) 
_ 


CDINIT(1/Q) 


Locate(Req,Fa,M5,P1,-DSR) ,Find(SLU,-DSL,~OCR) 
+——__ 


CDINIT(1I/Q) 
(2) Locate(Rep,Fa,M5,P1,D0SR) , Found (NN=VTAM1,CP=NNa, LU=SLU,DSL,-OCR) 
———_—_» 
CDINIT(Proceed) 
(3) Locate(Rep,Fa,M4,P1,DSR) , Found(NN=BNa,CP=NNa,LU=SLU,MSCP=VTAM1,DSL ,-OCR) 


_ 
CDINIT(Proceed BNa TGVs) 
(4) Locate(Req,Fa,M6,P2,-DSR) ,Find(SLU,-DLUS ,OCR) 
——> 
Cdinit(S) 
(5) Locate(Req,M6,P2,-DSR) ,Found(CP=NNa, LU=SLU,MSCP=VTAM1 , DLUS ,OCR) 
————_-. 


CDINIT(Proceed) 
(6) | Locate(Rep,Fa,M3,P2,-DSR) , Found (NN=BNb,CP=NNa,LU=SLU ,MSCP=VTAM1,DSL,-OCR) 
renee ner arr 


CDINIT(Proceed) 
Locate(Rep,Fa,M3,P2,7DSR) , 
Found (NN=ICBn,CP=NNa, LU=SLU ,MSCP=VTAM1,DSL,-0CR) 
—__—___+ 
CDINIT(Proceed) 


(7) Locate(Rep,Fa,M2,P2,7DSR) , 
Found(NN=BNc ,CP=NNa ,LU=SLU, 
MSCP=VTAM1,DSL,-OCR) 
CDINIT(Proceed,BNc TGVs) 


Locate(Rep,Fa,M1,P2, 
“DSR) , Found (NN=BNd, 
CP=NNa,LU=SLU, 
MSCP=VTAM1,DSL,70CR) 
———_—_» 
CDINIT(Proceed, 

BNc TGVs) 


Figure 261 (Part 1 of 2). PLU-Initiated Search with DLUS and DLUR within Different Sub- 
networks, PLU Through the Subarea 
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SUBAREA 


ICN ICN 
ICNa ICNb 


| 
RSP (BIND) | 


Locate(Discard, 
Fa,M1,P2) 


~4——_—______—_ 
CDINIT(SESSST) 


49 
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7) 
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” 
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ro) 
a] 
OQ 
lw 
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io 
| 


Locate(Discard,Fa,M2,P2) 

+. 

CDINIT(SESSST) 
Locate(Discard,Fa,M3,P2) 


| CDINIT(SESSST) 
Locate(Discard,Fa,M4,P2) 


CDINIT(SESSST) 
Locate(Discard,Fa,M5,P2) 


+ 
penetra en 


Figure 261 (Part 2 of 2). PLU-Initiated Search with DLUS and DLUR within Different Sub- 
networks, PLU Through the Subarea 


1. NNb initiates a search to locate the SLU. NNb has the location of the SLU 
cached, and the hierarchy indicates that BNd is the NNS(SLU). NNb sends a 
directed Locate to BNd to verify the location of the SLU and to obtain the SLU 
TGVs. 


BNd initiates a search to locate the SLU. The search ultimately reaches 
VTAM1. 


Neither the DSL nor DSR indicators will be set within the Find GDS variable on 
the search sent by NNb. | 


2. The OCR indicator is not set, so VTAM1 responds to the Locate. Since NNa is 
within a different subnet than VTAM1, and the PLU is also non-native, VTAM1 
will set the DSR indicator on the Locate reply. VTAM1 will also set the DSL 
indicator on the Locate reply since the SLU is a DLUS-served LU. 


3.. BNa caches the location of the SLU as being on NNa with VTAM1 as the NNS. 
Since the OCR indicator is not set on the reply, BNa does not set the OCR 
indicator within the cache entry. BNa then modifies the Found resource hier- 
archy to indicate itself as the NNS(DLU) and VTAM1 as the Management Ser- 
vices Control Point (MSCP). BNa also adds its own TGVs to the Locate reply. 


4. BNb caches the location of the SLU as being on NNa with BNa as the NNS. 
Since the OCR indicator is not set on the reply, BNb does not set the OCR 
indicator within the cache entry. 


Since the DSR and DSL indicators are set on the reply and BNb is returning a 
reply to a non-Border Node, BNb must obtain the SLU TGs to be included on 
the Locate reply which will be returned to the NNS(PLU). 


To obtain the TGVs, BNb initiates a Locate search to find the SLU. This 
search will be a PLU-init Search Only. The OCR indicator is set, requesting 
that the DLUR node respond to the Locate request. The DSR indicator will not 
be set, since BNb is the node which is performing the extra Locate search. 
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5. The OCR indicator is set, so NNa responds to the Locate. Since the SLU isa 
DLUS-served LU, NNa sets the DSL indicator on the reply. When building the 
reply, NNa will include a CV X'40' which includes the DLUS node's CP name. 


6. BNb caches the location of the SLU as being on NNa. Since both the DSL and 
OCR indicators are set on the Locate reply, BNb sets the OCR indicator within 
the cache entry. 


BNb modifies the Found resource hierarchy to indicate itself as the NNS(DLU). 
BNb removes BNa's TGVs from the reply. Since NNa is a network node, there 
are no TGVs to add to the Locate reply which is forwarded to ICNa. 


7. Since the DSR indicator is not set on the reply, neither BNc nor BNd will submit 
an extra Locate search to obtain the SLU TGVs even though each is closer to 
the PLU than BNb. 


When NNb receives the Locate reply, NNb calculates an RSCV and sends the 
BIND to NNa. This establishes the session between the PLU and the SLU. 
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PLU-Initiated Session with DLUS and PLU in one Subnetwork 
and DLUR in Another 


DLUR NNS BN BN DLUS NND cP 
(DLUR) (PLU) (PLU) 

ENa NNa BNa BNb VTAM1 NNb ENb 

| 


(1) Locate(Req,Fa,M1,P1,-DSR), 
Find(SLU,7DSL,-OCR) 
ed 
CDINIT(1/Q) 


(2) Locate(Req,Fa,M2,P1,-DSR), 
Find(SLU,7DSL,7OCR) 
+———_—_-. 
CDINIT(1/Q) 


(3) Locate(Req,Fa,M3,P2,7DSR) , 
Find(SLU,-DSL,OCR) 
ea 
CDINIT(S) 


Locate(Req,Fa,M4,P2,-DSR) ,Find(SLU,-DSL,OCR) 
<4 
CDINIT(S) 


Locate(Req,Fa,M5,P2,-DSR) ,Find(SLU,-DSL,OCR) 
<¢+——__—— 
CDINIT(S) 


Locate(Req,Fa,M5,P2,-DSR) ,Find(SLU,~DSL,OCR) 
+————_ 
CDINIT(S) 


(4) Locate(Rep, Discard, Fa,M5,P2,7DSR), 
Found(CP=ENa, LU=SLU ,MSCP=VTAM1,DSL,OCR) 
——_——_———_+ 
CDINIT(Proceed,DLUR, TGVs) 


Locate(Rep ,Discard,Fa,M5,P2,7DSR), 

Found (NN=NNa,CP=DLUR, LU=SLU,MSCP=VTAM1, DSL, OCR) 
—_——> 

CDINIT(Proceed,DLUR, TGVs) 


(5) Locate(Rep,Discard,Fa,M4,P2,7DSR), 
Found (NN=BNa, CP=DLUR,LU=SLU ,MSCP=VTAM1,DSL,OCR) 
—— 
CDINIT (Proceed, BNa, TGVs) 


(6) Locate(Rep,Discard,Fa,M3,P2,-DSR), 
Found(NN=BNb, CP=ENa,LU=SLU ,MSCP=VTAM1,DSL,OCR) 
—___—»| 
CDINIT(Proceed, BNa, TGVs) 


(7) Locate(Rep,Fa,M2,P2,-DSR), 
Found (NN=VTAM1 ,CP=DLUR, 
LU=SLU,DSL,70CR) 
—_—_—>| 
CDINIT (Proceed, BNa, TGVs) 


(8) Locate(Rep,Fa,M1,P2,7DSR), 
Found (NN=VTAM1,CP=DLUR, 
LU=SLU,DSL, OCR) 
aa ad 
CDINIT (Proceed, RSCV) 
eae | 


| | 
ENCAP(TH,RH,SESSST) , FQPCIDa Locate(Discard,Fa,M1,P2) 


wma ae —>_ <q_—_—_—— 
CDINIT(SESSST) 


BIND 


Locate(Discard,Fa,M2,P2) 
<4——__—_____ 
CDINIT(SESSST) 


Figure 262. PLU-Initiated Session with DLUS and PLU in Same Subnetwork and DLUR in 
Another 
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1. ENb initiates a search to locate the SLU. The search is forwarded to ENb's 
Network Node Server. Neither the DSL, DSR, nor OCR indicators will be set 
within the Find GDS variable. 


2. NNb initiates a search to locate the SLU. NNb has the location of the SLU 
cached, and the hierarchy indicates that VTAM1 is the NNS(SLU). NNb sends 
a directed Locate to VTAM1 to verify the location of the SLU and to obtain the 
SLU TGVs. 


3. The OCR indicator is not set, so VTAM1 responds to the locate. Since ENa is 
in a different subnet than VTAM1 no endpoint TGVs were reported over the 
CPSVRMGR pipe. Since NNb is within the same APPN subnet as VTAM1, 
VTAM1 must obtain the endpoint TGVs to be included in the Locate reply 
returned to NNb. 


To obtain the endpoint TGVs, VTAM1 initiates a new Locate search to find the 
SLU. This search will be a PLU-init Search-Only. The OCR indicator will be 
set, requesting that the DLUR node respond to the Locate request. The DSR 
indicator will not be set, since VTAM1 is the node which is performing the extra 
Locate search. 


When initiating the Locate search, a new PCID modifier slot will be allocated 
and the PRN will be incremented. This will allow the Locate search to appear 
as a new search within both the APPN and subarea networks. 


When searching their caches for the SLU, VTAM1, BNb, and BNa all look for 
entries where the OCR indicator is set. These entries will allow the nodes to 
route the Locate search to the DLUR node instead of the DLUS node. 


4. The OCR indicator is set, so ENa responds to the Locate. Since the SLU is a 
DLUS-served LU, ENa sets the DSL indicator. When building the reply, ENa 
will include a CV X'40' which includes the DLUS node's CP name. 


5. BNa caches the location of the SLU as being on the DLUR with NNa as the 
Network Node Server. Since both the DSL and OCR indicators are set on the 
search reply, BNa sets a OCR indicator within the cache entry. BNa then mod- 
ifies the Found resource hierarchy to indicate itself as the NNS(DLU). BNa 
also replaces the DLUR TGVs with its own TGVs before forwarding the Found 
to BNb. 


6. BNb caches the location of the SLU, with BNa as the NNS. As with BNa, a 
OCR indicator is saved with the cache entry. BNb then modifies the resource 
hierarchy so that it appears as the NNS(DLU). The Locate reply is then for- 
warded to VTAM1. 


7. VTAM1 caches the location of the SLU. As with BNa and BNb, VTAM1 sets 
the OCR indicator within the cache entry. VTAM1 then replies to the Locate 
search request received from NNb. Since the SLU is a DLUS-served LU, 
VTAM1 alters the Found hierarchy to indicate that VTAM1 is the NNS(DLU) 
and ENa is the CP(DLU). VTAM1 then removes the TGVs returned on the 
Locate reply received from BNb and places the TGVs on the Locate reply 
which it is constructing. Since the SLU is a DLUS-served resource, the DSL 
indicator is set. However, the DSR indicator is not set since VTAM1 has 
already obtained the correct DLUR TGVs. 


8. NNb calculates an RSCV using the endpoint TGVs returned by VTAM1. NNb 
returns the RSCV to ENb on the Locate reply. ENb then BINDs the session 
between the PLU and the SLU. 
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SLU-Initiated Session with DLUS and DLUR within Different 
Subnetworks 


(1) ENCAP(TH, sities an FQPCIDb | 
ee —> 


| 
ENCAP (TH,RH,RU(RSP)) . FOPCIDb 
| 
ENCAP(TH,RH,RU,MSG,8)),FOPCIDb 
| | 
ENCAP(TH,RH,RU(RSP) ) , FQPCIDb 


(2) Locate(Req,Fa,M1,P1,ISB,DSR) , 
Find(PLU,NN(OLU)=VTAM1 
CP(OLU)=ENa,DSL,~OCR) 


——_——> 
CDINIT(I) 
(3) Locate(Req,Fa,M2,P1,ISB,DSR), 


Find(PLU,NN(OLU)=BNb, | 
CP(OLU)=ENa ,MSCP=VTAM1 ,DSL ,-OCR) 
—_—— 


CDINIT(I) 
(4) Locate(Req,Fa,M3,P2,-DSR) , 
Find(SLU,-DSL,OCR) 
*—_—__—_—— 
CDINIT(S) 
(5) Locate(Req,Fa,M4,P2,-DSR), 
Find(SLU,7DSL,OCR) 
+ 
CDINIT(S) 
Locate(Req,Fa,M5,P2,-DSR), 
Find(SLU,-DSL,OCR) 
+ 
CDINIT(S) 
(6) Locate(Req,Fa,M6,P2,-DSR), 
Find(SLU,-DSL, OCR) 
+——_—_. 
CDINIT(S) 
Locate(Req,Fa,M6,P2,-DSR), 
Find(SLU,DSL,-0CR) 
_———_ 
CDINIT(S) 


(7) Locate(Rep,Discard,Fa,M6,P2,-DSR), 
Found(CP=ENa,LU=SLU MSCP=VTAM1, DSL,OCR) 
—_——>| 
CDINIT(Proceed,DLUR, TGVs) 


Locate(Rep,Discard,Fa,M6,P2,-DSR), 

Found (NN=NNa, CP=ENa, LU=SLU,MSCP=VTAM1 ,DSL,OCR) 
——> 

CDINIT(Proceed ,DLUR, TGVs) 


(8) Locate(Rep,Discard,Fa,M5,P2,~DSR), 
Found (NN=NNa,CP=ENa, LU=SLU,MSCP=VTAM1,DSL,OCR) 


er reegrenn ee 


Figure 263 (Part 1 of 2). SLU-Initiated Session with DLUS and DLUR within Different Sub- 
networks 
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NETA NETB 


Locate(Rep,Discard,Fa,M4,P2,-DSR), 
Found(NN=BNa,CP=ENa,LU=SLU ,MSCP=VTAM1 ,DSL,OCR) 


CDINIT (Proceed, NNb, TGVs) 


Locate(Rep,Discard,Fa,M3,P2,-DSR), 

Found (NN=BNb,CP=ENa,LU=SLU,MSCP=VTAM1 ,DSL,OCR) 
—_——_—_——» 

CDINIT(Proceed,BNb, TGVs) 


Locate(Req,Fa,M7,P2,1SB,-DSR), 
Find(PLU,NN(OLU) =BNc,CP(OLU) =ENA, 
MSCP(OLU)=VTAM1,DSL,7OCR) 
—_———> 

CDINIT(1I,BNB, TGVs) 


Locate(Req,Fa,M7,P2,ISB, ; 
“DSR) ,FIND(PLU,NN(OLU)=BNc, 
CP(OLU)=ENa,MSCP(OLU)=VTAM1, 
DSL,~0CR) 

+ 

CDINIT(I) 


Locate(Req,Fa,M8,P2,-DSR), 
Find(SLU,-DSL,-0CR) 
4 


CDINIT(S) 


Locate(Rep,Discard,Fa,M8, 
P2,-DSR) , Found(NN=BNc, 
CP=ENa,LU=SLU,MSCP=VTAM1, 
=DSL,70CR) 

——— 
CDINIT(Proceed, RSCV) 


BIND 


Locate(Rep,Discard,Fa,M7, 

P2,7DSR) ,FoundCP=ENb, 
ENCAP(TH,RH,SESSST) ,FQPCIDb LU=PLU,-~DSL,70CR) 
eaetitnetitnattiediCe ditentitentiontiontia titestiontitonticnttendtite iiteditetinmeen + 

CDINIT(SESSST) 


Locate(Rep,Discard,Fa,M7,P2,-DSR), 
Found( (NN=NNc,CP=ENb,LU=PLU, 
“DSL, -0CR) 
<q 
aie al 
Locate(Rep,Fa,M2,P2,-DSR), 
Found (NN=BNc ,CP=ENb,LU=PLU ,MSCP=NNc ,-DSL ,-OCR) 


—_— 
CDINIT(SESSST) 


Locate(Rep,Fa,M1,P2,-DSR), 
Found (NN=BNb,CP=ENb,LU=PLU ,MSCP=NNc ,~DSL,-OCR) 


en 
CDINIT(SESSST) 


Figure 263 (Part 2 of 2). SLU-Initiated Session with DLUS and DLUR within Different Sub- 
networks 


Ti 


1124 VTAM V4R2 Diagnosis 


The SLU initiates a Logon, which ENa encapsulates on the CPSVRMGR pipe 
and sends to VTAM1. VTAM1 sends a response to the Logon request followed 
by USS MSGO. Ena sends a response to USS MSG0O to VTAM1. 


. Prior to initiating a search to locate the PLU, VTAM1 examines its cache. The 


PLU is located and is cached as being accessible through BNb. Since ENa is 
in a different subnet than VTAM1, no endpoint TGVs were reported over the 
CPSVRMGR pipe. Since the PLU is also within a different APPN subnet, 
VTAM1 will set the DSR indicator on the Locate request. VTAM1 will also set 
the DSL indicator on the Locate request since the SLU is a DLUS-served LU. 
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3. BNb caches the location of the SLU as being on ENa with VTAM1 as the NNS. 
The OCR indicator will not be set in the cache entry. BNb has the PLU cached 
as being accessible through BNc. 


BNb modifies the Find resource hierarchy to indicate itself as the NNS(OLU) 
and adds a CV X'40' with VTAM1 as the MSCP. BNb also adds its endpoint 
TGs to the Locate search request and forwards the request to BNc. 


4. BNc caches the location of the SLU as being on BNb. The OCR indicator is 
not set within the cache entry. 


BNc has the location of the PLU cached as being within the native subnet. 
Since both the DSL indicator and the DSR indicator are set on the Locate 
request, BNc must obtain the SLU TGVs to be included on the Locate search 
request. 


To obtain the endpoint TGVs, BNc initiates a Locate search to find the SLU. 
This search will be a PLU-init Search Only. The OCR indicator is set, 
requesting that the DLUR node respond to the Locate request. The DSR indi- 
cator will not be set, since BNc is the node which is performing the extra 
Locate search. 


5. BNb receives the new Locate search from BNc. BNb finds a cache entry for 
the SLU with the OCR indicator set. The entry indicates that BNa is the 
NNS(SLU), so BNb forwards the Locate search to BNa. 


BNa also finds a cache entry for the SLU with the OCR indicator set. The 
cache entry for BNa indicates that the search should be forwarded to NNb. 


6. NNb receives the Locate search from BNa. As part of its search logic, NNb will 
send either a directed Locate search to NNa or will perform a network broad- 
cast which will ultimately reach NNa. Either way, the Locate search will be 
forwarded to NNa and, ultimately, ENa. 


7. The OCR indicator is set, so ENa responds to the Locate. Since the SLU isa 
DLUS-served LU, ENa sets the DSL indicator on the reply. When building the 
reply, ENa will include a CV X'40' which includes the DLUS node's CP name. 


8. NNb caches the location of the SLU as being on ENa, with NNa as the NNS. 
NNb then calculates an RSCV for the Bind route between BNa and ENa and 
returns the RSCV to BNa. 


9. BNa caches the location of the SLU as being on ENa, with NNb as the NNS. 
Since both the DSL and OCR indicators are set on the Locate reply, BNa sets 
the OCR indicator within the cache entry. 


BNa modifies the Found resource hierarchy to indicate itself as the NNS(DLU). 
BNa then removes the RSCV from the Locate reply and places NNb's TGVs on 
the reply. The reply is then returned to BNb. 


10. BNb caches the location of the SLU as being on ENa with BNa as the NNS. 
Both the DSL and OCR indicators are on the Locate reply, BNb sets the OCR 
indicator on the reply. BNb then modifies the resource hierarchy in the reply to 
indicate itself as the NNS(DLU). BNb also replaces NNb's TGs with its own 
TGs and then forwards the reply to BNc. 


11. BNc caches the location of the SLU as being on ENa with BNb as the NNS. 
Since both the DSL and OCR indicators are set on the Locate reply, BNc sets 
the OCR indicator within the cache entry. 
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BNc then takes the endpoint TGVs which were returned on the Locate reply 
which was just received from BNb and places the TGVs on the Locate request 
which was received from BNb. BNc then modifies the resource hierarchy on 
the request to indicate itself as the NNS(OLU). The search request is then 
sent to NNc. 


NNc forwards the search request to ENb. 


Because this is a SLU-init search request and an RSCV was not present on the 
Locate request, ENb initiates a PLU-init search with the SLU as the target. 


NNc correlates the PLU-init search request with the outstanding SLU-init search 
request. Using the information which was provided on the original SLU-init 
search, NNc calculates a RSCV and returns it to ENb on the Locate reply. 

ENb then BINDs the session between the PLU and the SLU. 


Since NNc creates the Locate reply instead of VTAM1, neither the DSL indi- 
cator nor the DSR indicator will be set on the reply. This can be contrasted to 
the original SLU-init request in which the DSL indicator was set. 
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Appendix G. Control Point/Control Block (CPCB) Operation 
Codes 


Many processes of the VTAM program are represented by RUPE, NCSPL, DLRPL, 
CPCB, PPL, NOSPL, MFT, FILTR, or TQE work elements. Each of these work 
elements contains a prefix called a CPCB at the beginning of the control block. 
The CPCB prefix contains a field called the CPCB operation code (CPCBOPC), 
which provides an indication of the type of VTAM process represented by the work 
element. 


The CPCBOPCs are mapped by the ISTCPKCB with reference to the data area. 
The CPCBOPC field is 4 bytes long and contains a category byte (CPCBCAT), fol- 
lowed by a 3-byte specific operation code field (CPCBFMHh). | 


The contents of the CPCB operation code category are summarized below: 


Category (hex) Meaning 

00 Operator command 

01 Dump/load/restart request 

02 I/O purge request 

03 Timer management request 

04 Unformatted RU 

08 Function management data RU 

09 Network control RU 

OA Data flow control RU 

0B Session control RU 

0c Function management data access method RU 
OD Network control access method RU 

OE Data flow control access method RU 

OF Session control access method RU 

FC Function management data access method interprocess signal 
FD Network interprocess signal 


Table 76 on page 1128 summarizes the possible values of the CPCB operation 
code field. 
Notes: 


1. For each CPCB operation code listed, the character string representation that 
may appear in VTAM operator messages is given, along with the function of 
the associated work element. 


2. Internal codes that are used only by the product support organization to assist 
in internal flow diagnosis are not included in this list. 
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Table 76 (Page 1 of 9). Control Point/Control Block Operation Codes (CPCBOPC) 


CPCBOPC 


00010000 
00010001 
00010002 
00010004 
~ 00010005 


00010008 
00010012 
00010032 
00010040 
00010041 


00010045 


00010080 
00010100 
00010200 
00010400 
00010802 
00011002 
00011802 
00012000 
00012001 


00012002 
00012005 


00014000 
00014010 
00014012 
00018000 
00018004 
00020000 
00020001 

00020002 
00020003 
00020004 
00020010 
000200A0 
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Message Display 
VARY 

VARY ACT 

VARY INACT 
VARY LOGON 
VARY ACT 


VARY DRDS 
VARY INACT 
VARY INACT 
VARY ANS 
VARY ACT 


VARY ACT 


VARY HANGUP 
VARY PATH 
VARY PATH 
VARY INOP 
FORCE DEAC 
FORCE REAC 
VARY INACT 
VARY ACQ 
VARY ACQ 


INACT SON 
VARY ACQ 


VARY REL 
VARY REL 
VARY REL 
VARY DIAL 
VARY NOLOGON 
F EXIT CMD 
F DUMP 

F ENCR 

F TOP 

F CHANGE 
F TABLE 

F TRACE 


Function 

VARY Command 
VARY Activate 
VARY Deactivate 
VARY LOGON 


VARY Activate, 
LOGON Parameter Specified 


VARY DRDS 

VARY Deactivate Immediate 

VARY Deactivate Immediate (Internal) 
VARY ANS 


VARY Activate, 
ANS Parameter Specified 


VARY Activate, 
ANS and LOGON Parameters Specified 


VARY HANGUP 

VARY PATH=USE 

VARY PATH=NOUSE 
VARY INOP 

Force Deactivate 

Force Reactivate 

VARY Deactivate Giveback 
VARY Acquire 


VARY Activate, 
ACQ Parameter Specified 


Deactivate (Session Outage Notification) 


VARY Activate, 
ACQ and LOGON Parameters Specified 


VARY Release 

VARY Release Immediate 
VARY Release Giveback 
VARY DIAL 

VARY NOLOGON 
MODIFY EXIT CMD 
MODIFY DUMP 

MODIFY ENCR 

MODIFY TOP 

MODIFY CHANGE 
MODIFY TABLE 

MODIFY TRACE, NETCNTR 
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Table 76 (Page 2 of 9). Control Point/Control Block Operation Codes (CPCBOPC) 


CPCBOPC 
000200C0 
00020120 
00020140 
00020180 
00020240 
00020200 
00020280 
00020401 
00020408 
00020480 
00020801 
00020808 
00020820 
00020840 
00020880 
00021001 
00021080 
00021801 
00022001 
00022080 
00022801 
00024001 
00024020 
00024040 
00028001 
00028820 
00028840 
0002C000 
0002D000 
0002E001 
0002E002 
00030001 
00030002 
00030004 
00040000 
00060001 
00060002 
00060004 
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Message Display 
F NOTRACE 

F AGPTRACE 

F DGPTRACE 

F LOAD ADD 
SETTIME 

F CDRM 

F LOAD REP 

F DUMP TRN 

F DR MOVE 

F LOAD PRG 
PRG NCP DUMP 
F DR DELETE 

F ALTRACE 

F DLTRACE 

F LOAD CNC 

F DUMP CSP 

F LOAD 

PRG DUMP CSP 
F DUMP MOS 

F LOAD 

PRG DUMP MOS 
F DUMP DYN 

F ACT SIT 

F DACT SIT 

F DUMP DYN CH 
F ATGTRACE 

F DTGTRACE 

F ALSLIST 

F DEFAULTS 

F DIR 

F DIR 

SOFT INOP 


SSCP TKOVR 


HARD INOP 
DISP INT 
INT SYNCH 
IPL INIT 
IPL TEXT 


Function 
MODIFY NOTRACE, NETCNTR 


CPCB Operation Codes (CPCBOPC) 


MODIFY Activate generalized PIU trace 
MODIFY Deactivate generalized PIU trace 


MODIFY LOAD ADD 
SETTIME Cancel 

MODIFY CDRM 

MODIFY LOAD REPLACE 
Transfer DUMP (NCP) 
MODIFY DR MOVE 
MODIFY LOAD PURGE 
PURGE DUMP (NCP) 
MODIFY DR DELETE 
MODIFY Activate Line Trace 
MODIFY Deactivate Line Trace 
MODIFY LOAD CANCEL 
MODIFY DUMP (CSP) 


MODIFY LOAD ACTION=SETTIME 


PURGE DUMP (CSP) 

MODIFY DUMP (MOSS) 
MODIFY LOAD ACTION=RENAME 
PURGE DUMP (MOSS) 
MODIFY Dump (Dynamic) 
MODIFY Activate SIT Trace 
MODIFY Deactivate SIT Trace 
MODIFY Dump (Dynamic-CH) 
MODIFY Activate TG Trace 
MODIFY Deactivate TG Trace 
MODIFY Adjacent Link Station List 
MODIFY DEFAULTS 

MODIFY DIR DELETE 

MODIFY DIR UPDATE 

SOFT INOP 

SSCP TAKEOVER 

HARD INOP 

Display Internal Commands 
Internal Synchronization Function 
IPL Initial Request 

IPL Text Request 
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Table 76 (Page 3 of 9). Control Point/Control Block Operation Codes (CPCBOPC) 


CPCBOPC 
00060008 
00060010 
00060020 
00060040 
00060100 
00061001 
00062000 
00062001 
00063001 
00063002 
00064000 
00064001 
00068000 
00080001 
012B0000 
014B0000 
01BD0000 
01DD0000 
01EA0000 
01ED0000 
02510000 
02520000 
03000000 
04000000 
08010001 
08010002 
08010003 
08010004 
08010201 
08010202 
08010203 
08010204 
08010205 
08010206 
08010207 
08010208 
08010209 
0801020A 
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Message Display 


IPL FINAL 
DUMP INIT 
DUMP TEXT 
DUMP FINAL 
HALT CDLNK 
REQDMP CSP 
RESET LU 
REQDMP MOS 
INT TRE DH 
INT TRF DMS 
REQLOAD 
REQDUMP DY 
REQDUMP 
DIAL START 
CKPTN 
CHKPT 
CPMSG 

DLR PURGE 
CPCRYPT 
SELECT VR 
CDRM CLEAR 
CDRM ERP 
TIMER REQ 
CHAR CODED 
CHG TLIMIT 
CHG NRSPOL 
CHG SESSLM 
CHG POLLIM 
CONTACT 
DISCONTACT 
IPL INIT 

IPL TEXT 

IPL FINAL 
DUMP INIT 
DUMP TEXT 
DUMP FINAL 
RMPO 
ACTLINK 


Function 

IPL Final Request 

Dump Initial Request 

Dump Text Request 

Dump Final Request 

Process Cross-Domain Links During HALT 
Request CSP Dump 

Reset LU 

Request MOSS Dump 

Internal transfer of dump header 
Internal transfer of dump main storage 
Request Load 

Request Dynamic Dump Data 
Request Dump 

Dial Start Request 

Checkpoint Node Status Function 
Checkpoint Resource Status Function 
Internal WTOR Function 
Dump/Load/Restart Purge 
Cryptography Management Function 
Virtual Route Select 

Clear CDRM-CDRM Session 

CDRM ERP Internal Clear 

Set Timer Request 

Unformatted Request Unit 

Change Transmission Limit 

Change Negative Response to Poll Limit 
Change Session Limit 

Change Poll Limit 

Contact 

Discontact 

NC IPL Initial 

NC IPL Text 

NC IPL Final 

Dump Initial 

Dump Text 

Dump Final 

Remote Power Off 

Activate Link 
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Table 76 (Page 4 of 9). Control Point/Control Block Operation Codes (CPCBOPC) 


CPCBOPC 
0801020B 
0801020E 
0801020F 
08010211 
08010214 
08010215 
08010216 
08010217 
08010218 
08010219 
0801021A 
0801021B 
08010280 
08010281 
08010284 
08010285 
08010302 
08010303 
08010331 
08010334 
08010381 
08010382 
08010383 
08010604 
08010681 
08010683 
08120100 
0812C200 
0812C300 
0812C400 
0812C500 
0812C900 
0812CA00 
0812CB00 
0812CC00 
0812CD00 
083F0233 
083F0234 
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Message Display 


DACTLINK 
CONNOUT 
ABCONN 
SCV 


ENT SLOWDN 
EXT SLOWDN 


ACTCONNIN 


DACTCONNIN 


ABCONNOUT 
ANA 
FNA 


~ REQDISCONT 


CONTACTED 
INOP 
REQCONT 
NSLSA 
ACTTRACE 
DACTTRACE 
DISP STOR 
RECSTOR 
RECMS 
REC TEST 
REC TRACE 
NSPE 

INIT SELF 
TERM SELF 
cP 

TDU 
REGISTER 
LOCATE 
CDINIT 
DELETE 
FIND 
FOUND 
NOTIFY 
lOCD 

INIT LOAD 
LOAD STAT 


Function 

Deactivate Link 

Connect Out 

Abandon Connection 

Set Control Vector 

Enter Slowdown 

Exit Slowdown 

Activate Connect In 
Deactivate Connect In 
Abandon Connect Out 

Assign Network Address 

Free Network Address 
Request Discontact 
Contacted 

Inoperative 

Request Contact 

Network Services Lost Subarea 
Activate Trace 

Deactivate Trace 

Display Storage 

Record Storage 

Record Maintenance Statistics 
Record Test Data 

Record Line Trace Data 
Network Services Procedure Error 
Initiate(Self) Format 0 
Terminate(Self) Format 0 

CP Capabilities 


TDU 


REGISTER Resource 
LOCATE Resource 
CDINIT 

DELETE 

FIND 

FOUND 

NOTIFY 

lOCD 

NS Init Load 

NS Load Status 
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Table 76 (Page 5 of 9). Control Point/Control Block Operation Codes (CPCBOPC) 


CPCBOPC Message Display Function 

083F0814 TR-INQUIRY Translate Inquiry 

083F0816 TR-REPLY Translate Reply 

08410210 RNAA Request Network Address Assignment 
08410220 NFY SESSEND Notify Sessend 

08410237 LOAD REQRD NS Load Required 

08410240 ADDNR Add Network Resource 

08410243 IPL INIT NS IPL Init 

08410244 IPL TEXT NS IPL Text 

08410245 IPL FINAL NS IPL Final 

08410246 IPL ABORT NS IPL Abort 

08410286 RDELETENR Request Delete Network Resource 
08410287 LOST CTLPT Lost Control Point 

08410289 ROUTE-INOP Network Services Route Inoperative 
0841028A REQACTCDRM Request ACTCDRM 

08410304 REQ MNT ST Request Maintenance Statistics 
08410305 LINKLVL2 Enter Test Mode (LL2) 

08410307 REQ RTTEST Request Route Test 

08410311 MS SCV Maintenance Services Set Control Vector 
08410384 RECFMS Record Formatted Maintenance Statistics 
08410385 RECTR Record Test Results 

08410386 ER TESTED Explicit Route Tested 

0841038D NMVT Network Manager Vector Transport 
08810387 REQ ECHO Request Echo Test 

08810389 ECHO TEST Echo Test 

08810601 CINIT Control Initiate 

08810602 CTERM Control Terminate 

08810620 NOTIFY Notify 

08810629 CLEANUP Cleanup 

08810680 INIT OTHER Initiate(Other) 

08810681 INIT SELF Initiate(Self) Format 1 

08810682 TERM OTHER Terminate(Other) 

08810683 - TERM SELF Terminate(Self) 

08810685 BIND FAIL Bind Failure 

08810686 SESS START Session Started 

08810687 UBIND FAIL Unbind Failure 

08810688 SESS ENDED Session Ended 

08810810 FORWARD Forward Request 

08810812 DELIVER Deliver Request 
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Table 76 (Page 6 of 9). Control Point/Control Block Operation Codes (CPCBOPC) 
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Appendix G. Control Point/Contro! Block (CPCB) Operation Codes 


CPCBOPC Message Display Function 
08810814 CNM REQ CNM Request 
08812601 BF CNTL INIT BF Control Initiate 
08812629 BF CLEANUP BF Cleanup 
08812681 BF INIT BF Initiate 
08812683 BF TERM BF Terminate 
08812686 BF SESS STRT BF Session Start 
08812688 BF SESS END BF Session End 
0881268C BF SESS INFO BF Session Information Request 
08818620 CD NOTIFY Cross-Domain Notify 
08818627 CD DSEARCH Cross-Domain Direct Search List 
08818640 CDINIT OTH Cross-Domain Initiate (Other) 
08818641 CDINIT Cross-Domain Initiate 
08818643 CDTERM Cross-Domain Terminate 
08818645 CDSSF Cross-Domain Session Setup Failure 
08818646 CDSESSST Cross-Domain Session Started 
08818647 CDSTF Cross-Domain Session Takedown Failure 
08818648 CDSESSEND Cross-Domain Session Ended 
08818649 CDTAKEDOWN Cross-Domain Takedown 
0881864A CDTD COMP Cross-Domain Takedown Complete 
0881864B CDCINIT Cross-Domain Control Initiate 
09050000 NCLSA Network Control Lost Subarea 
09060000 ER INOP Explicit Route Inoperative 
09060000 ANSS Auto Network Shutdown Started 
09070000 ANSC Auto Network Shutdown Complete 
09080000 LOST PATH Lost Path 
09090000 ER TEST Explicit Route Test 
O90A0000 ER TST RPY Explicit Route Test Reply 
090B0000 ER ACT Explicit Route Activate 
090C0000 ER ACT RPY Explicit Route Activate Reply 
090D0000 ACTVR Activate Virtual Route 
090E0000 DACTVR Deactivate Virtual Route 
090F0000 ER OP Explicit Route Operative oe 
09510000 SW TO NCP Switch Line to NCP Mode 
09520000 SW TO EP Switch Line to EP Mode 

~ 0A040000 LUSTAT LU Status 
OA050000 RTR Ready to Receive 
0A700000 BIS Bracket Initiation Stopped 
0A710000 SBI Stop Bracket Initiation 
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CPCB Operation Codes (CPCBOPC) 


Table 76 (Page 7 of 9). Control Point/Control Block Operation Codes (CPCBOPC) 


CPCBOPC Message Display Function 

0A800000 QEC Quiesce at End of Chain 
0A810000 QC Quiesce Complete 
0A820000 ~RELQ Release Quiesce 
0A830000 CANCEL Cancel 

0A840000 CHASE Chase 

0AC00000 SHUTDOWN Shutdown 

0AC10000 SHUTC Shutdown Complete 
0AC20000 RSHUTD Request Shutdown 
0AC80000 BID Bid 

OAC90000 SIGNAL Signal 

OBODO000 ACTLU Activate LU 

OBOE0000 DACTLU Deactivate LU 

0B110000 ACTPU Activate PU 

0B120000 DACTPU Deactivate PU 

0B140000 ACTCDRM Activate CDRM 
0B150000 DACTCDRM Deactivate CDRM 
0B310000 BIND — Bind Session 

0B320000 UNBIND Unbind Session 
OBAOO0000 SDT Start Data Traffic 
OBA10000 CLEAR Clear Session 

OBA20000 STSN Set and Test Sequence Numbers 
OBA30000 RQR Request Recovery 
OBCO00000 CRV Cryptography Verify 
0C0102A0 AM ALLORSC Allocate Resource 
0C0102A1 AM FREERSC Free Resource 
0C0102A2 AM SETRT Set Routable State 
0C0102A3 AM RESETRT Reset Routable State 
0C0102A5 SDDLU EXIT AMRU Secondary LU exit AMRU 
0C0102A4 AM SC EXIT Switched connection exit 
0C010480 AM RCRD MS DATA Record Measurement Data 
00410201 AM CONFIG SVCS Config SVCS 

00410206 AM GAINED GWN Gained GWN 

00410207 AM LOST GWN Lost GWN 

00410208 AM DACT TRF Deactivate Transforms 
00410210 AM RNAA Request Network Address Assignment 
00410212 AM CONN Connect 

00410213 AM DISC Disconnect 

00410214 AM INIT PU Initiate PU 
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Table 76 (Page 8 of 9). Control Point/Control Block Operation Codes (CPCBOPC) 


CPCBOPC 
0C410266 
0C4102BD 
0C4102BE 
0C4102BF 
0C4102CD 
0C4102CE 
0C4102CF 
0C410601 
0C410602 
0C800700 
0C800701 
0C810619 
0C810620 
0C810629 
00810643 
0C810680 
00810681 
0C810801 
0C810A00 
0C810A01 
0C810A02 
0C810A03 
0C810A04 
0C810A10 
0C810A20 
0C810A21 
0C810A22 
0C810A30 
0C810A31 
0C810A32 
0C810A33 
0C810A34 
0C810A35 
0C810A36 
0C810A37 
0C810A38 
0C810A39 
0C810A3A 
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Message Display 
XID 

AM ADDLINK 
AM ADDLSTA 
DELETENR 

AM REQDUMP 
AM CONDLOD 
AM UNCDLOD 
AM OPNACB 
AM CLSACB 
AM VCNS LREQ 
AM VCNS LRSP 
AM ARCA 

AM RESUME 
AM CLEANUP 
Generic TERM 
AM REALLOC 
GEN SESS INIT 
AM NOTIFY 
API SETLST 
API SETLSP 
AP! SETLQS 
API SETPER 
API SETNPE 
API SIMLOG 
API OPNACQ 
API OPNACC 
API OPNRES 
API INQLOG 
API INQDVC 
API INQCNT 
API INQTOP 
API INQCID 
API INQTRM 
API INQAPS 
API INQSPM 
API INQSKY 
API INQDSP 
API INQPER 


Function 

AM Exchange ID 

Add Link 

Add Link Station 

Delete Network Resource 
Request Dump 

Request Conditional Load 
Request Unconditional Load 
Open ACB 

Close ACB 

VCNS Logon Request 
VCNS Logon Response 
Address Request Complete 
Resume 

Cleanup 

Termination Placeholder 
Reallocate 

Generic Session Initiation 
Notify 
SETLOGON(START) 
SETLOGON(STOP) 
SETLOGON(QUIESCE) 
SETLOGON(PERSIST) 
SETLOGON(NPERSIST) 
SIMLOGON 
OPNDST(ACQUIRE) 
OPNDST(ACCEPT) 
OPNDST(RESTORE) 
INQUIRE(LOGONMSG) 
INQUIRE(DEVCHAR) 
INQUIRE(COUNTS) 
INQUIRE(TOPLOGON) 
INQUIRE(CIDXLATE) 
INQUIRE(TERMS) 
INQUIRE(APPSTAT) 
INQUIRE(SESSPARMS) 
INQUIRE(SESSKEY) 
INQUIRE(DISPLAY) 
INQUIRE(PERSESS) 
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Table 76 (Page 9 of 9). Control Point/Control Block Operation Codes (CPCBOPC) 


CPCBOPC 
0C810A3B 
0C810A40 
0C810A50 
0C810A51 
0C810A60 
0C810A70 
0C810A75 
0C810A80 
0C810A85 
0C810A90 
0C810AA0 
0C810AB0 
0C810ACO 
0D010000 
ODOBO00N 
ODOEO000 
ODFFOOO0O 
0E010000 
0F010000 
OF020000 
OF030000 
OF040000 
OF0O50000 
OFO60000 
0F310000 
0F320000 
FFOOO000 


1136 VTAM V4R2 Diagnosis 


Message Display 


API INQNQN 
API INTERP 
API CLSPAS 
API CLSRLS 
API SESONC 
API SNDCMD 
API SEND 
API RCVCMD 
API RECEIVE 
API REQSES 
API OPNSEC 
API TRMSES 
API RESETSR 
AM VR INOP 
AM REQ ERA 
AM REQ VRD 
AM VR STAT 
AM PCE 

AM NFY SLT 
AM SSA 

AM SSADISC 
AM OSA 

AM PWQ 

AM FLUSH 
AM GBIND 
AM GUNBIND 
VECTOR 


Function 

INQUIRE(NQN) 

INTRPRET 

CLSDST(PASS) 
CLSDST(RELEASE) 

SESSIONC 

SENDCMD 

SEND 

RCVCMD 

RECEIVE 

REQSESS 

OPNSEC 

TERMSESS 

RESETSR 

Virtual Route Inoperative 
Request Explicit Route Activate 
Request Virtual Route Deactivate 
Virtual Route Status 

Purge Chain Element 

Notify (Schedule LOSTERM Exit) 
Set Session Address 

Set Session Address and Disconnect 
Override Session Address 

Purge Wait Queue 

Flush Virtual Route 

Generic BIND 

Generic UNBIND 

VECTOR FMD request units 
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Appendix H. Storage and Control Block ID Codes 


This appendix lists the control block ID codes for VTAM and VSCS control blocks. 
It also includes storage ID codes for VSCS. 


This appendix contains the following sections: 


e “VTAM Control Block ID Codes” 
e “VSCS Storage and Control Block ID Codes (VM)” on page 1139. 


VTAM Control Block ID Codes 


You can identify certain VTAM control block types in a storage dump by examining 
an identification code in the first byte of the control block (offset 0). The control 
block identification codes are shown in the following table. In case of duplicate 
codes, use other means (such as the operating environment or the control block's 
context) to determine the type of control block. 


Note: Internal codes that are used only by the product support organization to 
assist in internal flow diagnosis are not included in Table 77. 


Table 77 (Page 1 of 2). Control Block ID Codes Table 77 (Page 1 of 2). Control Block ID Codes 
ID Control Block ID Control Block 
00 SONCB 1E RCE 
00 RPL 24 OCW 
01 RPH 26 PICB 
03 FMCB 29 LMPCB 
05 VRBLK 2B RAQ 
06 ICNCB 2C PAQ 
07 LDNCB 2D SAT 

09 HALCB 2E AHNCB 
0A BSCLB 41 PUSCB 
0B VLNCB 43 PLSCB 
oC PCLCB 45 POIA 
OD PRWCB 46 POCB 
OE TRGCB 47 POMCB 
OF ACDEB 48 PORCB 
10 UECB 49 POWE 
11 DYPAB 4C ~ ERCT 
13 TRAC 4D TGE 
14 ERT 4E VRWSE 
19 PDVT 50 DLRPL 
1A CHAIN 52 LUCB 
1B TGCB 54 RUPE 
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Table 77 (Page 2 of 2). Control Block ID Codes Table 77 (Page 2 of 2). Control Block ID Codes 


ID Control Block ID Control Block 
54 TUNB A2 RNCA 
58 TQE A3 ALCA 
5A PRQAB BD UDT 
5B PRBLK BE INT1 
5C CPCB BF COS 
60 NCSPL Co LOGMD 
61 PST C1 RPL6X 
62 AMU CA GRPCB 
62 NSSCB DO NIB 

62 NSICB EB AUTOE 
63 SMP FE XCNCB 
64 OCB FF OCA 
65 NACP ART ART 

66 CAB LSP LSPL 
67 CANT PRT PRTCB 
68 RSQE SAP SAPCB 
69 RDTPL | 

6A NOSPL 

6B SSIB 

6B CAR 

6C lIOSIB 

6D ASRIT 

6D RANT 

6E GWIT 

6F RARB 

75 WRE 

77 ADJSR 

78 ADJSS 

7B RIB 

81 EXLST 

96 SIBXN 

97 SIBIX 

98 SIB 

99 TSCB 

9A TSPL 

9B LSCB 

9C CNCB 

AO ACB 
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VSCS Storage and Control Block ID Codes (VM) 


You can identify certain VSCS control block types in a storage dump by examining 
either an identification code in the two bytes of the control block for the control 
block ID or the beginning of storage for the seven byte save area identifier. 


Storage Identifiers 


ID Storage Type 

Ss Static storage 

SD Dynamic storage 

ZZ Dummy storage prefix 


Control Block Identifiers 


ID Control! Block ID Control Block 


CG DTICGB 2R DTIWEB IRECEIVE one-way send 
Cl DTICIA 1S DTIWEB ISEND one-way reply 
CL DTICLB 2S DTIWEB ISEND one-way send 
CM DTICMD 3R DTIWEB IRECEIVE two-way reply 
DTICKWB DTISWBs for Communication Ser- 4R DTIWEB IRECEIVE two-way send 
vices 3S DTIWEB ISEND two-way reply 
DTIPSWB DTISWBs for Presentation Ser- 4S DTIWEB ISEND two-way send 
vices 
DTISPSB DTISWBs for Presentation Ser- 
vices Abends 
DTISUTB DTISWBs for Utility Services 
Abends 
DTISVSB DTISWBs for VTAM Services 
Abends 
DTITXWB DTISWBs for Timer Services 
DTIUSWB DTISWBs for Utility Services 
DTIVSWB DTISWBs for VTAM Services 
DTIVXWB DTISWBs for VTAM Exit Services 
IN DTIWEB internal 
PB DTIPDB 
PD DTIDSB for Presentation Services 
PG DTIPGB 
PL DTIPLB 
SA DTISAB 
SC DTISCB 
SM DTISDB 
TA DTITAB 
TD DTIGTD 
TR DTITHDR 
UG DTIUGB 
VA . DTIVAB 
VD DTIDSB for VTAM Services 
VE DTIVEIB | 
VG DTIVGB 
VL DTIVLB 
4| DTIWEB IREAD internal read 
buffer 
1R DTIWEB IRECEIVE one-way reply 
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Appendix I. Path Information Unit (PIU) Discard Reason 
Codes 


This appendix includes the following sections: 
e “PIU Discard Reason Code Descriptions” on page 1142 


e “Probable Causes of Discards” on page 1154. 


The VTAM program path information unit (PIU) discard reason codes can be found 
in session monitor trace panels and in the VTAM internal trace (VIT) DSCD entry. 
When VTAM’s transmission subsystem component (TSC) cannot forward a PIU 
toward its final destination, it generates a discard trace entry, consisting of a 
discard reason code and the discarded PIU. The TSC sends the discard trace 
entry to the NetView program, or to the VIT, or to both. 


Note: The NetView program must be active to VTAM in order to accept discard 
trace entries. The VIT must also be active. 


To reference all discard entries sent to the NetView program, issue the following 
NetView command: 


SESS *DISCARD 


The NetView program puts discarded PIUs in this file and, when possible, also puts 
them in the associated session trace file. 


Because PI|Us are often discarded without causing problems in the network, most 
discarded PiUs are not indicative of error conditions and do not need to be investi- 
gated. A discarded PIU should be investigated only if an error symptom, such as a 
“hang” condition, occurs. 


See Table 80 on page 1165 to determine what book describes session monitor 
trace panels. 


See “DSCD Entry for Discarded PIU Buffer rer 1)” on page 662 for a full 
description of the VIT DSCD entry. 
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PIU Discard Reason Code Descriptions 


Table 78 lists the VTAM discard reason codes for each BSC, HS, and TSC 
module that discards PiUs. BSC, HS, and TSC modules, with their associated 
reason codes, are listed in alphanumeric order. For each reason code, a specific 
reason is given for the discard, followed by a probable cause. Some probable 
causes are described in more detail in Table 79 on page 1154. 


Table 78 (Page 71 of 12). PIU Discard Reason Codes 


VTAM Module 


ISTBSCBC 
(receive BFCLEANUP) 


ISTBSCBP 

(boundary function 
pacing utility) 
ISTBSCBQ 

(receive BIND request) 


ISTBSCBR 
(receive negative 
BIND/GBIND response) 


ISTBSCIA 
(receive inoperative 
access method RU) 


ISTBSCMQ 
(receive MPTN 
Connect) 


ISTBSCRT 
(boundary function 
session services router) 


ISTBSCUA 
(receive UNBIND 
access method RU) 


ISTBSCUB 
(receive UNBIND 
request) 


Reason 
Code 
0001 


0001 


0001 
0002 


0001 


0002 
0001 


0001 


0001 
0002 
0003 


0001 


0001 
0002 


0003 
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Reason for Discard 


The link station is not connected. 


The link station is not connected. 


The link station is not connected. 


Storage could not be obtained for a BSB. 


The BSB could not be found from the 
network addresses in the transmission 
header. 


The BSB is not in a valid state. 


The BPB for the PU element address in the 
inoperative AMRU could not be found. 


The link station is not connected. 


An unrecognized response TSCB was 
received and freed. 


An unrecognized request AMRU was 
received and freed. 


This work element is being discarded 
because the NCB is being freed. 


The BSB for the session control block speci- 
fied in the UNBIND cleanup AMRU could 
not be found. 


The BSB could not be found when the 
UNBIND came from the PLU. 


The link station is not connected. 


The BSB is in the PLU initial state and the 
BSB has not been added to the subarea 
HASH table. 


Probable Cause 
(See Table 79) 


The link has become inopera- 
tive. 


The link has become inopera- 
tive. 


The link has become inopera- 
tive. 


Internal VTAM logic error. 


The session control block has 
already been freed. 


Internal VTAM logic error. 
Session control blocks have 


already been freed. 


The link has become inopera- 
tive. 


Internal VTAM logic error. 
Internal VTAM logic error. 
The link is becoming inopera- 


tive. 


The session control block has 


already been freed. 


The session control block has 
already been freed. 


The link has become inopera- 
tive. 


The session is being termi- 
nated by an UNBIND RU to 


the route extension PLU. 
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Table 78 (Page 2 of 12). PIU Discard Reason Codes 


VTAM Module 


ISTBSCUR 
(receive 
UNBIND/GUNBIND 
response) 


ISTBSCVR 

(boundary function 
session services VTAM 
recovery routine) 


ISTHSCEP 


ISTHSCGI 


ISTHSCRT 


ISTHSCRU 
ISTHSCRV 


ISTHSCSN 
ISTHSCSR 
ISTHSCTP 


ISTHSCTR 
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Reason 
Code 


0001 


0001 


0002 
0003 


0004 
0001 
0002 
0003 
0004 
0005 
0001 


0001 


0002 


0001 
0001 
0002 
0003 
0004 
0001 
0001 
0001 
0002 


0003 


0001 


Reason for Discard 


The BSB could not be found from the 
network addresses in the transmission 
header. 


An abend occurred while processing a 
response. 


An abend occurred while processing an RU. 


An abend occurred while processing an 
AMRU. 


A link inoperative condition has occurred. 
The BFSS PAB is being freed. 


The session is being deactivated. Unsent 
PiUs must be discarded. 


The session is being deactivated. PIUs on 
the pacing queue must be discarded. 


The session is being deactivated. PIUs on 
the HS PAB must be discarded. 


The session is being deactivated. Expedited 
flow PiUs must be discarded. 


The session is being deactivated. PIUs on 
the response queue are discarded. 


Either insufficient resources or LRM 
encounters an error while processing. 


A PIU that is not a BIND or UNBIND was 
received from another VTAM component on 
the expedited work queue. 


An SC PIU that is not a BIND or UNBIND 
was received from the network. 


Insufficient resources. | 
Format error on received request PIU. 
Format error on received response PIU. 
PIU received in incorrect state. 
Insufficient resources. 

Chaining state error. 

Chaining state error. 

Insufficient resources. 


Pacing response received when pacing is 
not supported. 


Insufficient resources for IPM acknowledge- 
ment. 


PIU received caused transmission control 
protocol violation. 


Appendix |. Path Information Unit (PIU) Discard Reason Codes 


Probable Cause 
(See Table 79) 


The session control block has 


already been freed. 


Internal VTAM logic error. 


Internal VTAM logic error. 


Internal VTAM logic error. 
Internal VTAM logic error. 
Internal VTAM logic error. 
Internal VTAM logic error. 
Internal VTAM logic error. 
Internal VTAM logic error. 
Internal VTAM logic error 
Internal VTAM logic error. 


Internal VTAM logic error. 


Internal VTAM logic error. 


Internal VTAM logic error. 
Internal VTAM logic error. 
Internal VTAM logic error. 
Internal VTAM logic error. 
Internal VTAM logic error. 
Internal VTAM logic error. 
Internal VTAM logic error. 
Internal VTAM logic error. 


Internal VTAM logic error. 
Internal VTAM logic error. 


Internal VTAM logic error. 
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Table 78 (Page 3 of 12). PIU Discard Reason Codes 


VTAM Module 
ISTLSC6I 


ISTLSC6Z 


ISTTSCBP 
(boundary pacing utility) 


-_ISTTSCBR 


ISTTSCCB 


ISTTSCCN 


ISTTSCCR 
(connection point 
manager receive) 


ISTTSCDR 
(data receive) 


ISTTSCFC 


ISTTSCGR 
(general response 
routine) 


Reason 
Code 
0001 
0002 
0001 


0003 
0004 


0001 


0001 
0002 


0003 
0004 


0005 
0001 


0001 


0001 


0002 


0003 
0004 


0001 


0001 


0002 


0001 


1144  VTAM V4R2 Diagnosis 


Reason for Discard 


TG segment out of sequence; connection 
will be terminated. 


Discard the request or response, due to 
connection termination. 


Previous PIU was lost. 
Segmenting length error. 


Accumulated PIU was discarded due to 
error. 


An unexpected pacing response has been 
received. 


BDU command code is not valid. 


No response to the command in progress, 
or the command in progress has been sent 
again. 


Control command is not valid. 


Not an error response, but SET MODE 
failed in processing completion of select 
BHSET command. 


CLEAR command in progress failed. 


Boundary half-session control block could 
not be found. 


Device was reset. 


The request TSCB is a PRI.DT.SEND ora 
SEC.DT.RCV in pending reset state. 


Inbound FMD request when SSCP-LU 
session is not active. 


HOT IO Condition 


An IPM was received that was of invalid 
length. 


Data was received but the session initiation 
macro (OPNDST or OPNSEC) is incom- 
plete. 


A partial PIU on the FMCB discarded 
because FMCEB is being cleaned up. 


A queued session control RU discarded 
because FMCB is being cleaned up. 


Response could not be generated because 
the PIU was FIDO, was not first in the 
segment, was already a response, or a 
response was not allowed by RH. 


Probable Cause 
(See Table 79) 


Network error. 


ISTTSCPD (PIU Deblocker) 
determined that PIU is not 
valid. 


Network error. 
Network error. 


Network error. 


The half-session partner is 
pacing the session after “No 
Pacing” specified on BIND. 


Session has been deacti- 
vated. 


Timing on LU-LU session 
traffic. 


Timing on SSCP-LU session 
traffic. 


Session is terminated during 
session initiation. 


Application program or 
session abended. 


Application program or 
session abended. 


Internal VTAM logic error. 
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Table 78 (Page 4 of 12). PIU Discard Reason Codes 


VTAM Module 
ISTTSCHT 


ISTTSCIP 
(host IRN processor) 


ISTTSCIR 


ISTTSCIS 

(inbound session 
control function inter- 
preter) 


ISTTSCIU 
(host IRN utility 
processor) 
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Reason 
Code 
0001 
0002 


0003 
0004 


0001 
0002 
0001 


0001 


0002 


0003 


0004 


0005 


0006 


0007 
0008 


0009 


0010 


0011 


0001 
0002 


Reason for Discard 


PIU is discarded from the PUT pending 
traffic queue. 


PIU is discarded from the NCB pending — 
traffic queue. 


PIU is discarded from the NCB work queue. 


PIU is discarded from the NCB inbound 
router PAB. 


The route is not available to the destination. 


A response cannot be generated. 


A partial PIU on the normal flow wait queue 
is discarded because PLUSC AMRU is 
received. 


The response is discarded when 
PRI.SESS.SEND is not in a pending active 
state. 


The response is discarded when 
PRI.DT.SEND is not in a pending active 
state. 


The response is discarded when 
PRI.DT.SEND is not in a pending reset 
state. 


The response is discarded when 
RQR.SEND is not in a pending state. 


The response is discarded when 


‘PRI.SESS.SEND or SEC.SESS.RCV is not 


in an active state. 
The session control response is not valid. 
Last in segment not received. 


Discard the request or response. 


Discard the request or response. 


PIUs on the response queue are discarded 
because CLEAR request received. 


A queued session control RU is discarded 
because CLEAR request received. 


The link is not contacted and active. 
No IRN extension exists on the NCB. 
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PIU Discard Reason Codes 


Probable Cause 
(See Table 79) 


Post-failure traffic purge. 
Post-failure traffic purge. 


A partial PIU is received 
when an entire PIU is 
expected. 


Timing on LU-LU session 
traffic. 


Timing on LU-LU session 
traffic. 


Timing on LU-LU session 
traffic. 


Timing on LU-LU traffic. 


Timing on LU-LU session 
traffic. 


Logical unit error. 
Logical unit error. 


An UNBIND has freed the 
PiUs on the half-session send 
queue. 


An UNBIND has freed the 
PiUs on the half-session 
pacing queue. 


Element on the response 
queue for CP-CP session. 


Session control RU purged. 


Post-failure traffic purge. 


Post-failure traffic purge. 
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Table 78 (Page 5 of 12). PIU Discard Reason Codes 


VTAM Module 
ISTTSCJS 


ISTTSCJUT 


ISTTSCKF 


ISTTSCKS 

(session control function 
interpreter for 
cryptography) 
ISTTSCLS 

(local 3270 write sched- 
uler) 


ISTTSCMB 
(migration BIND, 
UNBIND, ACTCDRM, 
DACTCDRM processor) 


ISTTSCNC 
(network control func- 
tion interpreter) 


Reason 
Code 


0001 


0002 


0003 


0004 


0001 


0002 


0003 


0004 


0001 


0002 


0003 


0004 


0001 


0001 


0002 


0001 


0002 
0003 


0001 
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Reason for Discard 


PiUs discarded from BCT pending traffic 
queue for logical unit session control 
request. 


PiUs discarded from BSCLB waiting printer 
end queue for logical unit session control 
request. 


PIUs discarded from BCT pending traffic 
queue for PU session control request. 


PlUs discarded from BSCLB waiting printer 
end queue for PU session control request. — 


PIU is discarded from the BCT pending 
traffic queue. 


PIU is discarded from the BSCLB waiting 
printer end queue. 


PIU is discarded from the PCPAB work 
queue. 


PIU is discarded from the BSCLB inbound 
router PAB. 


Data cannot be encrypted or decrypted on 
LU 6.2 session. 


Data length error during encryption on LU 
6.2 session. 


Pad count error during encryption on LU 6.2 
session. 


PIU discarded because of storage allocation 
failure. 


The request or response was discarded 
because ENCRYPTN=31 was specified as a 
start option but the cryptographic facility is 
not running in a 31-bit storage environment. 


The link is not yet active. 


The request was purged because of the 
session control request that followed. 


This is not a migration route. 


The ICNCB was not found. 


The virtual route (VR) number and the trans- 
mission priority (TP) number are not 0, as 
they must be for migration. 


The initialization complete request is the 
only inbound request allowed from network 
control. 


Probable Cause 
(See Table 79) 


Internal VTAM logic error. 


Received RU data is not a 
multiple of 8 bytes. 


Pad count on received data is 
less than 1 or greater than 7. 


Storage allocation failure. 


Post-failure traffic purge. 


Timing on LU-LU session 
traffic. 


Internal VTAM logic error or 
route has been redefined. 


Post-failure traffic purge. 


VR and TP numbers. must 
be O for migration. 


Error in network. 
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Table 78 (Page 6 of 12). PIU Discard Reason Codes 


VTAM Module 


ISTTSCNS 
(no session PAB 
processor) 


ISTTSCOS 
(outbound session 
control function inter- 
preter) 


ISTTSCPA 
(PLU activation router) 


ISTTSCPH 
(purge hot I/O 
processor) 


ISTTSCPI 
(path control inbound 
processor) 


ISTTSCPL 
(purge LUCB PABs) 


ISTTSCPR 
(path control router) 


ISTTSCQA 
(session activation 
request processor) 


ISTTSCQD 
(session deactivation 
request processor) 


ISTTSCQF 


ISTTSCQP 
(session deactivation 
processor) 
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Reason 
Code 


0001 


0001 


0002 


0003 


0004 


0001 


0001 


0001 


0001 


0001 


0001 


0001 


0002 


0001 
0002 


0001 


Reason for Discard 


No processing is required for this FIDO PIU. 


Discard the request or response. 


Discard the request or response. 


Discard the request or response. 


Discard the request or response. 


An unrecognized response RU was 
received. 


The RU size is exceeded, and the PIU is not 
for session control. 


The RU size is exceeded, and the PIU is not 
for session control. 


The RU is not for session activation or 
session deactivation. 


A response cannot be generated for an IRN 
PIU. 


A GBIND has been received for a link or 
station that is becoming inoperative. 


A contention ACTCDRM was discarded 
because a DACTCDRWM arrived from the 
same subarea. 


A contention DACTCDRM(SON) was dis- 
carded because an ACTCDRM for the same 
subarea had been previously received. 


Abend recovery PIU discard. 


A queued session control RU is discarded. 


An ACTCDRM was discarded due to 
ACTCDRM contention session restart. 


Appendix |. Path Information Unit (PIU) Discard Reason Codes 


Probable Cause 
(See Table 79) 


Timing consideration with 
BSC 3270. 


An UNBIND has freed the 
PlUs on the segment assem- 
bler queue. 


An UNBIND has freed the 
PiUs on the half-session send 
queue. 


An UNBIND has freed the 
PIUs on the half-session 
pacing queue 


An UNBIND has freed the 
PiIUs on the normal flow data 
queue. 


Internal VTAM logic error. 


Logical unit problem — logical 
unit sent a PIU larger than 
the BIND-specified maximum. 


Logical unit problem — logical 
unit sent a PIU larger than 
the BIND-specified maximum. 


An application has abended, 
and VTAM is freeing work for 
the application. 


Post-failure traffic purge. 


A GBIND has arrived for an 
LU that is subordinate to a 
PU or a link that is currently 
becoming inoperative. 


Operation — operator deacti- 
vated CDRM from one host 
after activation. 


The route over which the 
pending CDRM session is 
being activated has become 
inoperable. 


FMCB in recovery from 
ABEND 


Operation — CDRM activated 
from both hosts simultane- 
ously. 
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Table 78 (Page 7 of 12). PIU Discard Reason Codes 


VTAM Module 


ISTTSCRA 
(abend recovery) 


ISTTSCRI 
(virtual route path 
contro! inbound) 


ISTTSCRO 
(virtual route path 
contro! outbound) 


ISTTSCSA 
(segment assembler) 


ISTTSCSC 
(session serialization 
control) 


Reason 
Code 


0001 


0001 
0002 


0003 
0001 
0002 


0001 


0002 


0003 


0004 


‘0001 


1148 VTAM V4R2 Diagnosis 


Reason for Discard 


This is not a “first-in-segment” PIU. 


The origin subarea is not valid. 


The route is not usable. 


The sequence number is not valid. 


The route is not active. 


The activation number does not match the 
VR activation number. 


The beginning of the PIU segment was lost. 


Two “First-in-Segment” PlUs were received. 


Discard the partial PIU segment and 
retransmit the PIU. 


Hot I/O. Discard all PIU segments for this 
session. | 


Response PIU received that is not valid. 


The routing block code does not exist. 


Probable Cause 
(See Table 79) 


Post-failure traffic purge after 
application program abend. 


Adjacent NCP error. 


Post-failure traffic purge — 
ER not operative. 


Lost data or logical unit error. 
Post-failure traffic purge. 


Post-failure traffic purge. 


Network error. 


Check logical unit. 


Check logical unit. 


Check logical unit. 


A request has arrived for a 
resource attached to a link 
that is not currently active. 
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Table 78 (Page 8 of 12). PIU Discard Reason Codes 


Reason 
Code 


0001 
0002 


VTAM Module 


ISTTSCSR 
(LUCB session router) 


0003 


0004 


0005 


0006 


0007 


0008 


0009 


0010 


0011 


ISTTSCTD 
(TCP/IP Inbound 
Boundary Function) 


0001 


0002 


0003 


0004 
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Reason for Discard 
Incorrect virtual route !D. 


A complete DACTCDRM request caused by 
contention resolution, session override, or 
other session outage notification. 


Session deactivation response and state is 
not pending reset. 


Negative session activation response and 
flow direction does not match the direction 
indicator. 


Negative session activation response and 
sequence number that is not valid. 


Negative session activation response and 
state is not pending active. 


The session control response PIU is not 
flagged as expedited flow. 


The session deactivation response is not 
valid for the session type. 


An unsolicited session deactivation response 
was received and discarded. 


Protocol violation — negative response indi- 
cator not set in the RH of a negative BIND 
response. 


An UNBIND request discarded because 
session is not LU-LU. 


Non-session control RU received and the 
session is not active. 


The session is reset and an UNBIND 
request was received. 


A BIND response was received and the 
session is not pending active. 


Invalid Session Control request 


Appendix |. Path Information Unit (PIU) Discard Reason Codes 


Probable Cause 
(See Table 79) 


PIU originator error. 


Network operator error or 
transmission group failure. 


Out of synchronization. Pos- 
sibly misrouted. 


PIU originator error. 


Out of synchronization or lost 
traffic. 


Out of synchronization — 
multiple session activation 
and deactivation running con- 
currently. 


Protocol violation by the 
response originator. 


The application specified a 
user RH that is not valid — 
not indicating definite 
response. 


Session deactivation 
responses are being for- 
warded when a session deac- 
tivation request has not been 
sent. 


Protocol violation by the 
response originator. 


Internal VTAM logic error. 


Trailing session traffic exists 
on a session that is no longer 
active. 


Trailing session traffic exists 
on a session that is no longer 
active. 


The session has been deacti- 
vated. 


VTAM has received an invalid 
session control RU indicating 
an error in the network. 
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Table 78 (Page 9 of 12). PIU Discard Reason Codes 


Reason | Probable Cause 

VTAM Module Code Reason for Discard (See Table 79) 
ISTTSCTO 0001 Bind response was received and the session The session has been deacti- 
(TCPAP Outbound is not pending active. vated. 
Boundary -runcuen) 0002 Unbind response was received and the Trailing session traffic exists 

session is not pending reset. on a session that is no longer 

active. 

ISTTSCTR 0001 (PLU,SLU).BF.SESS.RCV is not pending A stray BIND response for a 
(boundary function active for the BIND response. previous session arrived 
transmission control before the expected BIND 
outbound) response, or the session 


partner changed his PCID 
between the BIND request 
and the BIND response. 


0002 (PLU,SLU).BF.CPMGR.RCV detected a The BIND request or the 
middie or last segment PIU for a BIU sent to BIND response received from 
a route extension that does not accept seg- the route extension during 
ments. session setup had the whole- 


bius required indicator set. 
The originator of the dis- 
carded PIU violated the pro- 
tocol. 
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Table 78 (Page 10 of 12). PIU Discard Reason Codes 


VTAM Module 


ISTTSCTS 
(boundary function 
transmission control 
inbound) 


ISTTSCTT 
(TCP/IP Write Sched- 
uler) 


ISTTSCWS 
(Communication 
controller/cluster con- 
troller write scheduler) 


ISTTSCYA 
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Reason 
Code 


0001 


0002 


0003 


0004 


0005 


0006 


0007 


0008 


0009 


0010 


0001 


0001 


0001 


Reason for Discard 


(SSCP,PU).BF.SESS.RCV is not pending 
active for the ACTPU response. VTAM was 
not waiting for an ACTPU response. 


(SSCP,PU).BF.SESS.RCV is not pending 
reset for the DACTPU response. VTAM 
was not waiting fora DACTPU response. 


(SSCP,SLU).BF.SESS.RCV is not pending 
active for the ACTLU response. VTAM was 
not waiting for an ACTLU response. 


(SSCP,LU).BF.SESS.RCV is not pending 
reset for the DACTLU response. VTAM was 
not waiting for a DACTLU response. 


(PLU,SLU).BF.SESS.RCV is not pending 
active for the BIND response. VTAM was 
not waiting for a BIND response. 


(PLU,SLU).BF.SESS.RCV is not pending 
active for the UNBIND response. VTAM 
was not waiting for an UNBIND response. 


There is an error in control vector hex 60. 


The indicator to accept segments into the 
subarea is off. 


VTAM received an unexpected request. 


(PLU,SLU).BF.SESS.RCV is reset upon 
receipt of an UNBIND. 


The link station is not connected. 


The channel link has not been contacted. 


A GBIND is being discarded. 


Probable Cause 
(See Table 79) 


Out of synchronization on 
SSCP-PU session. 


Out of synchronization on 
SSCP-PU session. 


Out of synchronization on 
SSCP-LU session. 


Out of synchronization on 
SSCP-LU session. 


Timing between SSCP ses- 
sions and LU-LU session — 
SSCP session reset during 
logical unit session activation. 


Timing between SSCP ses- 
sions and LU-LU session — 
SSCP session reset during 
logical unit session deacti- 
vation. 


A stray BIND response for a 
previous session arrived 
before the expected BIND 
response, or the session 
partner changed his PCID 
between the BIND request 
and the BIND response. 


The half-session partner is 
incapable of receiving PIU 
segments, but the other 
partner is sending one. 


Error in network. VTAM has 
received a session control 
request that is not valid. 


Timing on simultaneous 
session deactivation between 
VTAM and the session 
partner. 


The link has become inopera- 
tive. 


Post-failure traffic purge. 


Boundary PU has INOP'd. 
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Table 78 (Page 11 of 12). PIU Discard Reason Codes 


VTAM Module 
ISTTSCYP 


ISTTSCXS 
(channel-to-channel 
attachment write sched- 
uler) 


ISTTSC3R 
(3270 virtual PU/LU 
transmission control 
outbound) 


ISTTSC3S 

(3270 virtual PU/LU 
transmission control 
inbound) 


ISTTSC6F 


ISTTSC6I 
(LAN virtual link 
inbound data router) 


Reason 
Code 


0002 


0001 


0001 


0002 


0001 


0002 


0003 


0004 


0005 


0006 


0007 


0008 


Reason for Discard 


A trailing UNBIND response was received 
and discarded. 


The channel link is not in contacted or active 
state. 


DT.RCV is not active. 
The session is being reset. 


The session was not active, and the PIU 
received did not contain a session control 
RU. 


(SSCP,PU).SEC.SESS.RCV is not pending 
active for the ACTPU response. VTAM was 
not waiting for an ACTPU response. 


(SSCP,PU).SEC.SESS.RCV is not pending 
reset for the DACTPU response. VTAM 
was not waiting fora DACTPU response. 


(SSCP,SLU).SEC.SESS.RCV is not pending 
active for the ACTLU response. VTAM was 
not waiting for an ACTLU response. 


(SSCP,SLU).SEC.SESS.RCV is not pending 
reset for the DACTLU response. VTAM was 
not waiting fora DACTLU response. 


(PLU,SLU).SEC.SESS.RCV is not pending 
active fora BIND response. VTAM was not 
waiting for a BIND response. 


(PLU,SLU).SEC.SESS.RCV is not pending 
reset for the UNBIND response. VTAM was 
not waiting for an UNBIND response. 


For an LU-LU session, the 
DATATRAFFIC_RCV is not active. 


Probable Cause 
(See Table 79) 


Session resources have 
already been freed and 
reused for a new session. 


Post-failure traffic purge. 


Timing on LU-LU session 
traffic. 


Timing on LU-LU session 
traffic. 


Timing on LU-LU session 
traffic. 


Out of synchronization on 
SSCP-PU session. 


Out of synchronization on 
SSCP-PU session. 


Timing between SSCP-PU 
and SSCP-LU sessions. 


Timing between SSCP-PU 
and SSCP-LU sessions. 


Timing between SSCP ses- 
sions and LU-LU session — 
SSCP session reset during 

LU-LU session activation. 


Timing between SSCP ses- 


- sions and LU-LU session — 


SSCP session reset during 
LU-LU session deactivation. 


Timing on LU-LU session 
traffic. 


No discard codes from this module. Using TSALERT with reason code 0 for normal PIU 


discard. 
0001 
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Discard the request or response, due to 
connection termination. 


ISTTSCPD (PIU deblocker) 
determined that the PIU is not 
valid. 
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Table 78 (Page 12 of 12). PIU Discard Reason Codes 


Reason 
VTAM Module Code 
ISTTSC6T 0001 
(LAN virtual link con- 
nection terminator) 0002 
0003 
ISTTSC6Z 0001 
0002 
0003 
0004 
ISTTSC8X | 0001 
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Reason for Discard 


Discard the request or response, due to 
connection termination. 


Discard the request or response, due to 
connection termination. 


Discard the request or response, due to 
connection termination. 


End of PIU lost. 


Retransmission of PIU, discard the partial 
PIU. 


Segmenting length error. 
Queue freed — segmenting error. 


A PIU on the outbound work queue is dis- 
carded. 


Appendix |. Path Information Unit (PIU) Discard Reason Codes 


PIU Discard Reason Codes 


Probable Cause 
(See Table 79) 


The PIU was on the NCB 
work queue. 


The PIU was on the NCB 
pending queue. 


The PIU was on the inbound 
segmenting queue. 


Error in network. 


Error in network. 


Error in network. 
Error in network. 


Multipath channel station (PU) 
is being deactivated. 
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Probable Causes of Discards 


Table 79. Probable Causes of Discards 


Probable Cause 


Timing on LU-LU session 
traffic 


Timing between SSCP 
sessions and LU-LU 
session 


Timing between 
SSCP-PU and SSCP-LU 
sessions 


Post-failure traffic purge 


Internal VTAM logic error 
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Explanation of Cause 


This discard can occur on the session between the application program and the SLU. It 
is usually caused by a reset request (for example, a Clear or a BIND) from the applica- 
tion program. This type of discard does not usually cause a problem in the network. 


This discard usually occurs when a reset of the SSCP-PU or SSCP-LU session affects a 
pending initiation or termination of the LU-LU session. For example, if the application 
program issues a CLSDST request to the logical unit, VTAM sends an UNBIND request 
to the logical unit. If the SSCP-LU session fails before the UNBIND response comes 
back, the UNBIND response is discarded. This type of discard does not usually cause a 
problem in the network. 


This discard usually occurs when a reset of the SSCP-PU session affects a pending 
initiation or termination of the SSCP-LU session. For example, if the operator deacti- 
vates the logical unit, VTAM sends a DACTLU to the logical unit. If the SSCP-PU 
session fails before the DACTLU response comes back, the DACTLU response is dis- 
carded. This type of discard does not cause a problem in the network. 


This discard may be caused by a network failure. Any PIU traffic arriving after the 
network failure but before the session is terminated can be purged using the discard 
function. For example, after a channel I/O error, PIUs that continue to be queued out- 
bound over the channel can be discarded. This type of discard does not usually cause 
a problem in the network. 


This discard indicates a hardware or software error in the network; it usually occurs after 
a major SNA protocol violation. For example, if VTAM is waiting for a sequence number 
of 0008 but receives a PIU with sequence number 0010, PIUs with sequence numbers 
0008 and 0009 are missing. The missing PIUs could have been lost anywhere in the 
session path, or perhaps they were not sent. The logical unit, physical unit, line, NCP, 
channel, or VTAM might be responsible for the problem. 


Further investigation is usually required to determine where in the network the problem 
is. The session type and reason code determine what type of documentation is needed 
to resolve a problem identified by this discard code. 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” Glossary, Bibliography, and Index 
Licensed Materials — Property of IBM 


Glossary, Bibliography, and Index 


GIOSSAIY) ig 2h hw eh we EER ERE CREASES EADS Ew ADEN RS 1157 
Bibliography ...... 1... 2. 1159 
VTAM V4R2 Publications ...........0.. 0.0.0.0 000 eee ees 1159 
Softcopy Information ......... 0... 00.000 pee ee 1159 
Marketing Information .........0..0 0.0.00 000 eee ee 1159 
PIAMIUAG). cane fes be Bice baa he Bae SO hoe SE SO Sy ee ae 1159 
Installation, Resource Definition, and Tuning ................. 1161 
Operation: 65 pak oe eae Se ho he ew bh Sgr ek A eee ed 1161 
GUSIOMIZANON. «sen eek Boe hd Kw EE ad oo a ME OS we 1162 
Writing Application Programs ....... 2... 2... ee ee 1163 
IDIAQMOSIS®. <5.-5.a-% end ay Mh & eho Sarak Ske OM oom Seabee tee aie eo wt & ae 4 1163 
VTAM AnyNet Feature for V4R2 for MVS/ESA  ................ 1164 
MPTN Architecture Publications .................0. 2.00008. 1164 
APPC Application Suite Feature for V4R2 for MVS/ESA .......... 1164 
IAGO oak vor eres & Aes ee bo ee oe ee ee ee 1169 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 | 1155 


Glossary, Bibliography, and Index “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


1156  VTAM V4R2 Diagnosis LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” Glossary, Bibliography, and Index 
Licensed Materials — Property of IBM 


Glossary 


For definitions of the terms and abbreviations used in this book, refer to the VTAM Glossary. 
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Bibliography 


VTAM V4R2 Publications 


Following are descriptions of the books in the VTAM 
V4R2 library for the MVS/ESA, VM/ESA, and VSE/ESA 
operating systems. The books are arranged here 
according to the tasks they describe: 


Planning 

Installation, Resource Definition, and Tuning 
Customization 

Operation 

Writing Application Programs 

Diagnosis 

Quick Reference. 


The complete set of unlicensed books in this section 
can be ordered using a single order number, 
SBOF-4394 for MVS, SBOF-7001 for VM, and 
SBOF-7002 for VSE. 


Softcopy Information 


IBM Networking Softcopy Collection 
Kit CD-ROM (SK2T-6012): 


The softcopy library contains softcopy versions of the 
licensed and unlicensed books for VTAM V4R2 and the 
VTAM AnyNet Feature for V4R2 for MVS/ESA. 


All of the unlicensed and licensed VTAM books 
described in this section are available in softcopy on 
this CD-ROM. These softcopy files can be read using 
any of the IBM BookManager READ programs. They 
can also be read with the IBM Library Reader program 
shipped on this CD. 


In addition, this CD contains the Online Message 
Facility. The Online Message Facility is an OS/2 
program that provides online access to information from 
VTAM Messages and Codes and other BookManager 
softcopy books. The facility helps network operators 
and system programmers operate and diagnose prob- 
lems without interrupting those tasks. 


The CD also contains softcopy of the unlicensed books 
of many other products. 
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Marketing Information 


A Networking Overview and the following IBM Net- 
working Previews are available: 


e AnyNet 
e VTAM. 


Ask your IBM marketing representative for more infor- 
mation. 


Planning 


Planning for NetView, NCP, and VTAM 


(SC31-7122): This book helps you plan for new 
products or for migrating to new releases of networking 
products. It describes product functions, explains bene- 
fits you can gain from using them in different situations, 
and address cross-product implications. The book con- 
tains cross-task reference information and storage esti- 
mates. 


Planning for Integrated Networks 


(SC31-7123): This book helps you plan for SNA 
(subarea and APPN) and TCP/IP networks. It includes 
discussion of protocol strategies, migration scenarios, 
processing goals, and management considerations. 


Planning Aids: Pre-installation Plan- 
ning Checklist for NetView, NCP, and 
VTAM (SX75-0092): This checklist identifies 


important tasks to consider and complete before you 
begin to install these product. The document can be 
reproduced and folded to fit easily in a pocket or folder 
for quick reference and easy portability. 


VTAM Licensed Program Specifica- 


tions (GC31-6490): This flyer is the warranty 
for VTAM and includes: 


e A list of new functions 

e Descriptions of VTAM features 
e Machine requirements 

e Programming requirements. 
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VTAM Release Guide for MVS/ESA 


(GC31-6492): This guide provides an overview of 
the new functions in VTAM V4R2 and includes: 


Advantages of new functions 

Planning considerations for new functions 

Effect of new functions on existing functions 
Changes to commands, definition statements, and 
messages | 

e Programming requirements, such as the release of 
NCP required. 


VTAM Release Guide for VM/ESA | 


(GC31-8089): This guide provides an overview of 
the new functions in VTAM V4R2 and includes: 


e Advantages of new functions 

e Planning considerations for new functions 

e Effect of new functions on existing functions 

e Changes to commands, definition statements, and 
messages 

e Programming requirements, such as the release of 
NCP required. 


VTAM Release Guide for VSE/ESA 


(GC31-8090): This guide provides an overview of 
the new functions in VTAM V4R2 and includes: 


Advantages of new functions 

Planning considerations for new functions 

Effect of new functions on existing functions 
Changes to commands, definition statements, and 
messages 

e Programming requirements, such as the release of 
NCP required. 


VTAM Migration Guide for MVS/ESA 


(GC31-6491): This guide helps you upgrade 
VTAM V4R1, V3R4.2, V3R4.1, V3R4, or V3R3 to VTAM 
V4R2. It includes: 


e Planning to upgrade to VTAM V4R2 
— Upward and downward compatibility 
— Software and hardware requirements — 
— Storage requirements 
— Impacts of new functions and enhancements 
performed without changes to user interfaces 
— Changes to installation process 
e Upgrading user interfaces to VTAM V4R2 
— Changes to start options 
— Changes to buffer pools 
— Changes to definition statements 
~ Changes to IBM-supplied default user-definable 
tables and modules 
— Changes to user-definable table macroin- 
structions 
— Changes to commands 
~ Changes to messages 
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— Changes to VTAM application podem 
interface 
‘— Changes to installation-wide exit routines 
— Changes to control blocks 
e¢ Implementing optional functions and enhancements 
introduced in VTAM V4R2 
~— Overview of each new function and enhance- 
ment introduced since VTAM V3R3 
— Pointers to other books in the library where 
implementation details can be found. 


VTAM Migration Guide for VM/ESA 


(GC31-8071): This guide helps you upgrade 
VTAM V3R4.1 or V3R4 to VTAM V4R2. It includes: 


e Planning to upgrade to VTAM V4R2 
~ Upward and downward compatibility 
— Software and hardware requirements 
— Storage requirements 
— Impacts of new functions and enhancements 
performed without changes to user interfaces 
~ Changes to installation process 
e Upgrading user interfaces to VTAM V4R2 
— Changes to start options 
— Changes to buffer pools 
— Changes to definition statements 
~— Changes to IBM-supplied default user-definable 
tables and modules 
— Changes to user-definable table macroin- 
structions 
— Changes to commands 
— Changes to messages 
— Changes to VTAM application programming 
interface 
— Changes to installation-wide exit routines 
— Changes to control blocks 
e Implementing optional functions and enhancements 
introduced in VTAM V4R2 
— Overview of each new function and enhance- 
ment introduced since VTAM V3R4 
— Pointers to other books in the library where 
implementation details can be found. 


VTAM Migration Guide for VSE/ESA 


(GC31-8072): This guide helps you upgrade 
VTAM V3R4, V3R3, or V3R2 to VTAM V4R2. It 
includes: 


e Planning to upgrade to VTAM V4R2 
— Upward and downward compatibility 
~— Software and hardware requirements 
— Storage requirements 
_— Impacts of new functions and enhancements 
performed without changes to user interfaces 
— Changes to installation process 
e Upgrading user interfaces to VTAM V4R2 
— Changes to start options 
— Changes to buffer pools 
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— Changes to definition statements 

— Changes to IBM-supplied default user-definable 
tables and modules 

— Changes to user-definable table macroin- 
structions 

— Changes to commands 

~— Changes to messages 

— Changes to VTAM application programming 
interface 

— Changes to installation-wide exit routines 

— Changes to control blocks 

e Implementing optional functions and enhancements 
introduced in VTAM V4R2 

— Overview of each new function and enhance- 
ment introduced since VTAM V3R2 

— Pointers to other books in the library where 
implementation details can be found. 


Estimating Storage for VTAM 


(SK2T-2007): This interactive program helps you 
estimate the storage requirements for VTAM. The 
diskette includes: 


e Step-by-step procedures 
e Formulas used to calculate storage. 


VTAM Overview for VM/ESA and 


VSE/ESA (GC31-8114): This document is 
designed to be used with each book of the VTAM 
library. It helps you understand which functions are 
included with each package available for VTAM V4R2 
for VM/ESA and VSE/ESA. 


e VTAM V4R2 Client/Server 
¢ VTAM V4R2 MultiDomain 
e VTAM V4Rz2 InterEnterprise. 


lt also provides instructions for how to order a particular 
package. 


VTAM Glossary (GC31-6558): | This glos- 


sary defines terms and abbreviations for VTAM and 
related products. It includes information from the IBM 
Dictionary of Computing, SC20-1699. 


installation, Resource Definition, 
and Tuning 


VTAM Network Implementation Guide 


(SC31-6494): This book presents the major con- 
cepts involved in implementing a VTAM network, and 
includes: 


e Buffer pools, slowdown, pacing, storage consider- 
ations 
e Implementation considerations 
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Installation procedures 

Sample major node definitions 

Migration considerations 

Tables and filters 

TSO, VSCS, VCNS, and other programs that run 
with VTAM 

e Tuning procedures 

e VTAM start options. 


Use this book in conjunction with the VTAM Resource 
Definition Reference. 


VTAM Resource Definition Reference 


(SC31-6498): This book describes each VTAM 
definition statement, start option, and macroinstruction 
for user tables. It also describes NCP definition state- 
ments that affect VTAM. The information includes: 


e |IBM-supplied default tables (logon mode, USS and 
X.25) 

DTIGEN macroinstruction (VSCS start options) 
Major node definitions 

User-defined tables and filters 

VTAM start options. 


If you are unfamiliar with the major concepts involved in 
implementing a VTAM network, use this book in con- 
junction with the VTAM Network Implementation Guide. 


VTAM Resource Definition Samples 


(SC31-6499): This book contains sample defi- 
nitions to help you implement VTAM functions in your 
networks, and includes sample major node definitions. 


Use this book in conjunction with the VTAM Network 
Implementation Guide and VTAM Resource Definition 
Reference. 


Operation 


VTAM Operation (SC31-6495): = This book 
serves as a reference for programmers and operators 
requiring detailed information about specific operator 
commands. The information includes: 


e VTAM commands and start options 

e Logon manager commands 

e DISPLAY output examples (messages received) 
e VSCS commands. 


VTAM Operation Quick Reference 


(SX75-0205): This book contains essential infor- 
mation about VTAM and VSCS operator commands. 
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VTAM Messages and Codes 


(SC31-6493): This book describes messages, 
codes, and other information associated with VTAM 
messages and includes: 

e Messages: 


— ELM messages for logon manager 

— IKT messages for TSO/VTAM 

— IST messages for VTAM network operators 
— ISU messages for sockets-over-SNA 

~— USS messages 

— VSCS messages 


¢ Codes and other information that display in VTAM 
messages: 


— Abend codes 
— Command and RU types in VTAM messages 
— Node and ID types in VTAM messages 


— Return codes for macroinstructions including 
_ACB OPEN and CLOSE macroinstruction error — 
fields, RTNCD-FDB2 return code combinations, 
and LU 6.2 RCPRI-RCSEC return codes 


— Sense codes including VTAM sense code hints, 
SNA sense field values for RPL-based macroin- 
structions, and 3270 SNA and non-SNA device 
sense fields 


— Status codes including resource status and 
session state codes 


— Wait state event codes and IDs 
e Supplemental message-related information: 
— Message additions, deletions, and changes 
— Message flooding prevention 
— Message groups and subgroups 


— Message routing and suppression including 
descriptor codes, routing codes, and sup- 
pression levels for ELM, IKT, IST, and ISU mes- 

_ sages 


— Message text and description formats 


— Message text of MSGLVL option messages 
including general information on the MSGLVL 
option 


— Message text of all VTAM network operator 
messages including variable field lengths 


— Online Message Facility. 
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Using IBM CommandTree/2 


(SC31-7013): IBM CommandTree/2 is a work- 
station product that enables an operator to construct | 
commands and send them to a specified destination for 
processing. The VTAM command set library includes: 


e VTAM commands 

e Logon manager commands 

e Help for commands and start options. 
e VSCS commands 


Customization 


VTAM Customization (LY43-0063): This 


book enables you to customize VTAM, and includes: 


¢ Communication network management (CNM) 
routing table 


e Installing tables and modules in VM 
e Logon-interpret routine requirements 


e Logon manager installation-wide exit routine for the 
CLU search exit 


e VSCS data manipulation installation-wide exit 
routine 


e TSO/VTAM installation-wide exit routines 
-e VTAM installation-wide exit routines: 
— Command verification exit (ISTCMMND) 


— Configuration services XID exit (ISTEXCCS) 
with description of IBM-supplied default exit 


— Directory services management exit 
(ISTEXCDM) 


~— Generic resource resolution exit (ISTEXCGR) 


— SDDLU exit (ISTEXCSD) with description of 
IBM-supplied default exit 


— Session accounting exit (ISTAUCAG) 
— Session authorization exit (ISTAUCAT) 


— Session management exit (ISTEXCAA) with 
example 


— TPRINT processing exit (ISTRAEUE) 


~ USERVAR exit (ISTEXCUV) with description of 
IBM-supplied default exit 


— Virtual route pacing window size calculation exit 
(ISTPUCWC) 


— Virtual route selection exit (ISTEXCVR).. 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Writing Application Programs 


VTAM Programming (SC31-6496): This 
book describes how to use VTAM macroinstructions to 
send data to and receive data from (1) a terminal in 
either the same or a different domain, or (2) another 
application program in either the same or a different 
domain. The information includes: 


e API concepts 
— Cryptography 
— RUs and exchanges 
— Session establishment and termination 
BIND area format 
Communication Network Management Interface 
Dictionary of VTAM macroinstructions 
OPEN or CLOSE errors 
Operating system differences 
Program Operator Coding requirements 
RAPI DSECTs and control block mappings 
RAPI global variables 
Resource-identification and access-method-support 
vector lists 
e RPL-based macroinstructions 
e RPL RTNCD,FDB2 codes 
e User exit routines. 


VTAM Programming for LU 6.2 


(SC31-6497): This book describes the VTAM LU 
6.2 programming interface for host application pro- 


grams. This book applies to programs that use only LU 


6.2 sessions or that use LU 6.2 sessions along with 


other session types. (Only LU 6.2 sessions are covered 


in this book.) The information includes: 


Allocating and deallocating conversations 
APPCCMD macroinstructions and LU 6.2 DSECTs 
BIND image and response and ISTDBIND 
Conversation states 
Description and use of the following control blocks: 
— CNOS session limits control block 
— DEFINE control block 
— DISPLAY control block 
— RESTORE control block 
e FMH-5 and PIP data 
e LU 6.2 global variables 
e Resource-identification and access-method-support 
vector lists 
e RCPRI,RCSEC codes 
e Sample program for retrieving RESTORE informa- 
tion 
e Sample VTAM LU 6.2 application program 
e Session- and conversation-level security and data 
encryption 
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Sending and receiving data 

Sense codes for FMH-7 and UNBIND 
Summary of register usage 

Sync point services 

User exit routines. 


Diagnosis 


VTAM Diagnosis (LY43-0065): This book 
helps you identify a VTAM problem, classify it, and 
collect information about it before you call the IBM 
Support Center. The information collected includes 
traces, dumps, and other problem documentation. The 
information includes: 


e Command syntax for running traces and collecting 
and analyzing dumps 

e VIT entries 

e Procedures for collecting documentation (VTAM, 

VSCS, TSO) 

VTAM internal trace and VIT analysis tool 

FFST Probes 

Channel programs 

Flow diagrams 

Procedures for locating buffer pools 

VSCS dump and traces 

CPCB operation codes 

Storage and control block ID codes 

PIU discard reason codes 

Offset names and locations for VTAM buffer pools 


VTAM Data Areas for MVS/ESA 


(LY43-0064): This book describes VTAM data 
areas and can be used to read a VITAM dump. It is 
intended for IBM programming service representatives 
and customer personnel who are diagnosing problems 
with VTAM. 


VTAM Data Areas for VM/ESA 
(LY43-0103): This book describes VTAM data 


areas and can be used to read a VITAM dump. It is 


intended for IBM programming service representatives 
and customer personnel who are diagnosing problems 
with VTAM. 


VTAM Data Areas for VSE/ESA 


(LY43-0104): This book describes VTAM data 
areas and can be used to read a VIAM dump. It is 
intended for IBM programming service representatives 
and customer personnel who are diagnosing problems 
with VTAM. 
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VTAM AnyNet Feature for V4R2 
for MVS/ESA 


VTAM AnyNet Feature for V4R2: Guide 
to Sockets over SNA Gateway for OS/2 


(SC31-6528): This guide provides information to 
help you install, configure, use, and diagnose the 
sockets-over-SNA-gateway function for OS/2. This 
function allows socket applications running on a TCP/IP 
network to communicate with socket applications 
running on an SNA network. 


VTAM AnyNet Feature for V4R2: Guide 
to Sockets over SNA (SC31-6526): This 


guide provides information to help you install, configure, | 


use, and diagnose Sockets over SNA. It also provides 
information to help you prepare application programs to 
use sockets over SNA. 


VTAM AnyNet Feature for V4R2: Guide 
to SNA over TCP/IP (SC31-6527): This 


guide provides information to help you install, configure, 
use, and diagnose SNA over TCP/IP. 
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MPTN Architecture Publications 
Networking Blueprint Executive Overview (GC31-7057) 


Multiprotocol Transport Networking: Technical Overview 
(GC31-7073) 


Multiprotocol Transport Networking: Formats 
(GC31-7074) 


APPC Application Suite Feature 
for V4R2 for MVS/ESA | 


APPC Application Suite User's Guide 


(SC31-6532): This book documents the end-user 
interface (concepts, commands, and messages) for the 
AFTP, ANAME, and APING facilities of the APPC Appli- 
cation Suite for MVS/ESA. Although it's primary audi- 
ence is the end user, administrators and application | 
programmers may also find it useful. 


APPC Application Suite Administration 


(SC31-6533): This book contains the information 
that administrators need to configure the APPC Applica- 
tion Suite for MVS/ESA and to manage the APING, 
ANAME, AFTP, and A3270 servers. 


APPC Application Suite Programming 


(SC31-6534): This book provides the information 
application programmers need to add the functions of 
the AFTP and ANAME APIs to their application pro- 
grams. 
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Table 80 (Page 1 of 3). Related Information on Problem Topics in Other Libraries 


Topic 
3174 Controller 


Abend codes 


Abend dump 

ACF/TAP 

Alert major vector and its subvectors 
Alerts 


Allocating extents 
CCS 
CCW trace 


Channel programs 


CNOS return codes 


Communication scanner output 


CP operator commands, 
CP SIO 


CP TRACE command 


CP traces 

DEDICATE directory statement 
Directory services management exit 
DOSVSDMP dump contents 


Dump collecting, formatting, and printing 


Dump information, retrieving from tape 
Dumping CP storage 

DUMPLOAD 

Dynamic tracing of ICAs 

EREP 


ERP 

Exception request (EXR) 

First Failure Support Technology (FFST) 
Full-screen mode 

GCS commands 

GCS SIO 

Generalized trace facility (GTF) 

Generic alerts 

HCPRIO 
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See 
3174 Functional Description 


MVS/ESA System Codes 
VM/ESA System Messages and Codes 


MVS/ESA JCL Reference 
NCP, SSP, and EP Diagnosis Guide 
SNA Network Product Formats 


NetView Operation 
SNA Network Product Formats 


Planning for NetView, NCP, and VTAM 
VM/ESA CP Programming Services 
MVS/ESA Diagnosis: Tools and Service Aids 


IBM 4361 Processor Communication Adapter 

IBM 9370 Information System: Telecommunications Subsystem Description and 
Reference 

Principles of Operation manual for your communication controller 

Principles of Operation manual for your operating system 


VTAM Programming for LU 6.2 


NCP, SSP, and EP Diagnosis 
NCP Reference Summary and Data Areas 
Principles of Operation manual for your communication controller 


VM/ESA CP Command and Utility Reference 


VM/ESA CP Command and Utility Reference 
VM/ESA Virtual Machine Operation 


VM/ESA System Operation 

VM/ESA CP Planning and Administration 
VTAM Customization 

VSE/ESA Diagnosis Tools 


MVS/ESA Diagnosis: Tools and Service Aids 
VM/ESA Diagnosis Guide 
VSE/ESA Diagnosis Tools 


VSE/ESA Diagnosis Tools 
VM/ESA System Operation 
VM/ESA Dump Viewing Facility 
VSE/ESA Diagnosis Tools 


EREP User's Guide and Reference 
VM/ESA System Operations 


SYS1.LOGREC Error Recording 

SNA Network Product Formats 

First Failure Support Technology for VM and MVS Operator's Guide 
TSO/E Programming Services 

VM/ESA Group Control System 

VM/ESA Diagnosis Guide 

MVS/ESA Diagnosis: Tools and Service Aids 

See Alerts. 

VM/ESA Planning and Administration 
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Table 80 (Page 2 of 3). Related Information on Problem Topics in Other Libraries 


Topic 


Hung NCP, 
Hung resources attached to an NCP, 
Hung sessions 


ICA interface to VTAM 
ICA sense codes 


IEBGENER utility 
Intensive mode recording 


I/O control blocks 


I/O traces 


IPCS, running in batch mode, 
IPCS commands 


IPCSPRNT 


IUCV 
IUCV external interrupts 


IUCV CONNECT return codes 
Job control language (JCL) 


Line trace records 
LIST Service Aid 
LOGDATA option 
LOGREC 


Maintain System History Program (MSHP) 
MVS IKJxxxx system messages 

MVS system codes 

NCP data areas, registers, and codes 


NCP dumps, 
NCP service aids 


NCP, tuning 
NetView Session Monitor 
NMVT RUs 


Program status words (PSWs) 
PSWs, locating in dump output 


PRTDUMP 

RECMS RU formats 

Reshow processing 

Retrieving dump information from tape 
RTCT 


RU opcodes 
SDAID 
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See 
NCP, SSP, and EP Diagnosis Guide 


IBM 4361 Processor Communication Adapter 


IBM 9370 Information System: Telecommunications Subsystem Description and 


Reference 
MVS Utilities 
NCP, SSP, and EP Diagnosis Guide 


MVS/ESA Diagnosis: Data Areas 
VM/ESA Diagnosis Guide 
VSE/ESA Diagnosis Tools 


MVS/ESA Diagnosis: Data Areas 

VM/ESA CP Command and Utility Reference 
VM/ESA Diagnosis Guide 

VSE/ESA Diagnosis Tools 


MVS/ESA Interactive Problem Control System (IPCS) Commands 
MVS/ESA Interactive Problem Control System (IPCS) User's Guide 


MVS/ESA Interactive Problem Control System (IPCS) Customization 
VM/ESA CP Programming Services 


GCS Reference for ESA 


MVS/ESA JCL Reference 
MVS/ESA JCL User's Guide 


NCP, SSP, and EP Diagnosis Guide 
MVS/ESA Diagnosis: Tools and Service Aids | 
MVS/ESA Interactive Problem Control System (IPCS) Commands 


SYS1.LOGREC Error Recording 
EREP User's Guide and Reference 


VSE/ESA System Control Statements 

MVS System Messages 

MVS/ESA System Codes 

NCP and EP Reference Summary and Data Areas 
NCP, SSP, and EP Diagnosis Guide 


NTune User's Guide 
NetView Operation 


SNA Network Product Formats 
NetView Operation 


Principles of Operation manuals 
VSE/ESA Diagnosis Tools 


VM/ESA Dump Viewing Facility 

NCP and EP Reference Summary and Data Areas 
TSO/E Programming Services 

VSE/ESA Diagnosis Tools 


MVS/ESA Diagnosis: Data Areas 
VM/ESA Diagnosis Guide 


SNA Formats 
VSE/ESA Diagnosis Tools 
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Table 80 (Page 3 of 3). Related Information on Problem Topics in Other Libraries 


Topic 

SDATA options 
SDUMP 

Session monitor 
SIOF 

SLIP dump 

SMP 

SNA sense codes 
Socket API calls 
SPTAPE 
Stand-alone dump 
STATMON 

SVC dump 

SVC 93 and SVC 94 entries 
SYSREC 


Task control blocks 


TCB, map of 


TGET options, 
TGET return codes 


TGET/TPUT option flags 

Time of day clock entry in trace output 
TPUT opiions, editing done by 
TRACERED 


TRSAVE, 
TRSOURCE 


Virtual machine branch trace, 
VM commands 


VMFPLC2 
VMFZAP 
VSE dumps, obtaining and formatting 
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See 

MVS/ESA Operations: System Commands 
VM/ESA Diagnosis Guide 

See NetView Session Monitor. 

VM/ESA CP Command and Utility Reference 
MVS/ESA Diagnosis: Tools and Service Aids 


System Modification Program Extended User's Guide 


SNA Formats 

TCPAP for MVS Programmer's Reference 
VM/ESA CP Command and Utility Reference 
MVS/ESA Diagnosis: Tools and Service Aids 
See NetView Session Monitor. 

MVS Operations: System Commands 
MVS/ESA Diagnosis: Tools and Service Aids 
VSE/ESA System Control Statements 


MVS/ESA Diagnosis: Data Areas 
VM/ESA Diagnosis Guide 
VSE/ESA Diagnosis Tools 


MVS/ESA Diagnosis: Data Areas 
TSO/E Programming Services 


MVS/ESA Diagnosis: Reference 

Syster/370 ESA Principles of Operation 
TSO/E Programming Services 

VM/ESA Dump Viewing Facility 

VM/ESA CP Command and Utility Reference 


VM/ESA CP Command and Utility Reference 


VM/ESA Service Guide 
VM/ESA Service Guide 
VSE/ESA Diagnosis Tools 
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Index 


Special Characters 
**"* (FFST) trace record 568 


Numerics 
3279 color terminal 171 
3720 communication controller, alert messages 
from 539 
3725 communication controller, alert messages 
from 539 
3745 communication controller 
alert messages from 539 
bus switching 549 


A 


abend (abnormal end) 
codes 
OAQ9 152 
OAB 117 
OAC 118 
OAD 119 
OAx 61 
0C1 148 
0C2 147 
0C4 7 
OCx 60 
15D 119 
804 152 
878 152 
diagnosis procedure 58 
dump 214 
finding the abend code 59 
symptoms 6, 39 
trace records 
abend RELSTORE 594 
ABND SNAP _ 569 
TSO/VTAM 
diagnosis procedure 117 
documentation requirements 117 
symptoms 113 
VSCS 
after message DTIC10I 173 
diagnosis procedure 152 
during present initialization 147 
during previous initialization 144 
VTAM address space 280 
ABND trace record 569 
ABND trace record (VSCS) 488 
ACA1 trace record 570 
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index 


ACA2 trace record 572 
ACAS trace record 573 
ACF/TAP (trace analysis program) 361 
ACI1 trace record 570 
ACl2 trace record 572 
ACI3 trace record 573 
ACNT trace record (VSCS) 472 
ACP1 trace record 574 
ACP2 trace record 576 
ACR1 trace record 574 
ACR2 trace record 576 
ACRC trace record 578 
ACSN trace record 579 
activation 
CDRM 18 
GCS 144 
major node 14 
NCP 25 
network traces 349 
VTAM recovery machine 144 
ACU1 trace record 580 
ACU2 trace record 581 
ADP (adapter) trace record 582 
ADP2 (adapter) trace record 583 
ADSP trace record 584 
All trace record 585 
Al2 trace record 587 
Al3 trace record 588 
alert messages 539 
ALS trace record 589 
alternate screen size, PSERVIC coding 127 
analyzing dumps with IPCS VTAMMAP 240 
AnyNet trace format for SNA over TCP/IP 376 
AP trace record 591 
APAR (authorized programming analysis report) 48 
API option 
VIT trace records created 
Ali 585 
Al2 587 
Al3 588 
lO1 703 
lO2 (MVS) 705 
lO2 (VM) 706 
lO2 (VSE) 705 
lO3 (MVS) 707 
lO3 (VM) 708 
lO3 (VSE) 707 
RE 770 
summary 401 
UE 804 
UE1 805 
UE2 807 
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index 


API option (continued) 
VIT trace records created (continued) 
UP 810 
APPC option 
VIT trace records created 
ACA1i 570 
ACA2 572 
ACA3 573 
ACI1i 570 
ACI2 572 
ACI3 573 
ACP1 574 
ACP2 576 
ACR1 574 
ACR2 576 
ACU1 580 
ACU2 580 
RACR 766 
summary 401 
APPC sense code 226 
application program 
log 50 
performance group specification (TSO/VTAM) 129 
problems 48 
termination (VSCS) 169 
wait 70 
APPN flows 
See flows 
AREL trace record 594 
ASCB trace field 367 
ASKQ item, in problem reporting 5 
asynchronous dispatch trace record 584 
ATCASLIP 227 
ATSK trace record 595 
ATT (attention) trace record 596 
AUTH operand (TSO/VTAM) 129 
authorized IO trace record 585 
authorized programming analysis report (APAR) 48 
available storage, VSCS, determining amount 149 
AXIT trace record 597, 600 


backspace key functions improperly 123 
BFRFIFO command 450 
BIND in logon, detecting incorrect portion of 115 
BIND location 127 
BINFM, coding 115 
bracket in buffer contents trace output 120 
BSPx trace record 598 
BTSK trace record 601 
buffer contents trace 

confidential data 373 

description 369 

full 370 
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buffer contents trace (continued) 


operation 371 
output 372 
partial 370 
when to use 370 


buffer extents, effect on performance 


(TSO/VTAM) 129 


buffer pool 


analyzing usage 195, 377 
control block relationships 838 
expansion, EXPN trace 676 
finding 837 


buffer use 


trace 377 

trace format 
MVS 378 
VM _ 378 
VSE 


buffer use (SMS) trace 


description 377 
format 
MVS 378 
VM 378 
VSE 379 
operation 378 
when to use 377 


buffer use display 195 
bus switching 549 


C 


call progress signal (CPS) 918 
CCI or CCO trace record 


NCSPL 604 
not RUPE or NCSPL_ 606 
RUPE 602 


CCS trace (VSCS) 458 


data trace record 472 
record foran LU 467 
record, global 470 — 


CCW trace 98, 351 
CFC2 trace record 609 
CFCE trace record 607 
CFCN trace record 608 
CFDS trace record 610, 611 
CFEE trace record 612 
CFER trace record 615 
CFFC trace record 616 
CFL2 trace record 619 
CFLS trace record 617 
CFNF trace record 620 
CFRB trace record 621 
CFS option 


VIT trace records created 
summary 401 
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CFUS trace record 623 
CHANGE command 450 
change command, not working 183 
change direction indicator in buffer contents trace 
output 120 
changing screen size in non-full-screen 
processing 127 
channel I/O (CIO) VIT option 
See CIO option 
channel programs 
APPN host-to-host channels 881 
BSC communication adapter line 904 
channel-attached non-SNA 3270 devices 899 
channel-attached type 2 and 4 PUs 874 
channel-to-channel adapters 881 
multipath channels 881 
PUNS-related 880 
SDLC communication adapter line 911 
channel-attachment major node, I/O trace 374 
character delete key functions improperly 123 
Cli trace record 625 
Ci2 trace record 628 
Cli3 trace record 631 
Cl4 trace record 632 
CICS, logon failure 17 
CIO option 
VIT trace records created 
ADP2 583 
ADPA 582 
ADPI 582 
ADPO 582 
ATT 596 
CONN 640 
CPTO 649 
DISC 657 
ERP (MVS) 671 
ERP (VM) 667, 668 
ERP (VSE) 668 
HIO 688 
HIOP 690 
INT (MVS) 693 
INT (VM) 692, 695, 701 
INT (VSE) 698 
INT2 694 
LIC! 720 
LICO 720 
LICS 720 
LNKA 725 
LNKI 725 
LNKL 725 
LNKx 725 
PIC 754 
PKT| 757 
PKTO 757 
PKTX 758 
SIO (MVS) 782 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


ClO option (continued) 

VIT trace records created (continued) 
SIO (VM) 781, 782 
SIO (VSE) 781, 782 
SlO2 (MVS) 784 
S102 (VM) 784 
SlO2 (VSE) 784 
SIOP 786 
summary 401 
XID 832 
XID2 833 

cleanup trace (VSCS) 458 

cleanup trace records 478 

CLISTs 

detailed descriptions 245 

errors, debugging 241 

help, obtaining online 241 

ISTVABND 280 

ISTVDUMP 283 

ISTVMAP 286 

ISTVSAVE 288 

ISTVSLIP 291 

output, printing 242 

overview 241 


CLSDST PASS, possible cause for failure 116 


CMS edit mode (VSCS) 535 
CMS message prefix 146 
CMS mode, LU hangs during 170 
CMSG trace record (VSCS) 473 
CNCT trace record (VSCS) 474 
CO1 trace record 625 
CO2 trace record 628 
CO3 trace record 631 
CO4 trace record 632 
codes, CPCB operation 1127 
colons as incorrect output (TSO/VTAM) 125 
color 
3279 terminal (VSCS) 171 
incorrect on screen (VSCS) 169 
commands 
incorrectly. processed (VSCS) 187 
operator (VSCS) 450 
operator, DISPLAY and MODIFY 193 
rejected (TSO/VTAM) 113 
to access printer (VSCS) 185 


index 


to change screen size in non-full-screen processing 


(TSO/VTAM) 127 

common problems 6 

APPN 27 

path and routing 199 

subarea 6 

VIT analysis tool 42 

VTAM dump analysis tool 46 
common symptoms 39 


Index 
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index 


communication adapter lines, error recording for 556 
communication scanner processor (CSP) 
dump 230 
trace 390 
component ID 52 
component recovery area (CRA) 79 
components 
connected to anLU 172 
in VSCS initialization 142 
concatenated input 123 
confidential data in buffer contents trace 373 
configuration data set 51 
CONN trace record 640 
console communication services (CCS) trace 
(VSCS) 131, 458 
data trace record 472 
record foran LU 467 
record, global 470 
console log 52 
console mode (VSCS) 535 
console mode, LU hangs during 170 
content of data stream is wrong (VSCS)_ 171 
control blocks 
formatted ina dump 232, 233, 235 
ID codes 
for VSCS 1139 
for VTAM 1137 
TAB, PLB, and VLB in adump 161 
control operator control block (COPR), finding 248 
control point/control block (CPCB) operation 
codes 1127 
contro! register O bit 30, setting 144 
coordinated universal time (Greenwich mean time) 312 
COPR (control operator control block), finding 248 
COs 
undefined entry, (APPN) 29 
undefined entry, (subarea) 17 
CP Diagnose x'24 21 
CP Diagnose x'24' 
CP message prefix 146 
CPCB operation codes 1127 
CPMSG trace record 736 
CPPG trace record 641 
CPPT trace record 641 
CPR2 trace record 647 
CPR3 trace record 648 
CPRC trace record 646 
CPTO trace record 649 
CPTRAP 359 
CPU trace field 367 
CPW2 trace record 651 
CPWS3 trace record 652 
CPW4 trace record 653 
CPWAIT macro 651, 653 
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CPWT trace record 650 

CRA 79 

CRA trace record 654 

CRALKACT 79 

CRALxPTR fields 79 

CRD trace record 654 

CRF trace record 654 

cross-domain logon problem 116 

CSI messages, issuing component 

CSP (communication scanner processor) 
dump 230 
trace 390 

current entry location in VSCS internal trace table 162 

current LU, location (VSCS) 162 

CXIT trace record (VSCS) 486 


D 
DAT trace (VSCS) 458 
data 
display problem (TSO/VTAM) 121 
incorrect content 
TSO/VVTAM 114 
VSCS_ 171, 178 
VTAM 96 
incorrect length (TSO/VTAM) 114 
incorrect translation (TSO/VTAM) 125 
misplaced 
TSO/VTAM 124 
VSCS 178 
data circuit-termination equipment (DCE) 918 
data sets, formatted dump 240 
data trace (VSCS) 458 
data trace records 491 
DBD trace record 656 
DBQ trace record 656 
DBU trace record 656 
DCSS MAP, location of 50 
deactivating the VIT 410 
default 
logmode name in USS command 127 
screen size 127 
definite response mode (DR) 132 
detected waits increase 114 
detection points, first failure support technology 217 
device characteristics, determining VSC 135 
DIAG24 exec 22 
diagnosing problems in VTAM dump analysis 46 
diagnosing problems, where to begin 3 
DISC trace record 657 
discard reason codes 1141 
discards, probable causes of PIU 1154 
disconnect problems, documentation for (VSCS) 159 
disconnection 
LU hangs during (VSCS) 172 
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disconnection (continued) 
of LU during full-screen mode (VSCS) 169 
DISP trace (VSCS) 458 
dispatch trace entries 
IRBs 712 
PABs 664 
redispatching 777 
SRBs 793 
dispatchable, condition of VSCS 160 
dispatcher trace (VSCS) 458 
record foran LU: Entry 1 492 
record for an LU: Entry 2 495 
record, global 497 
showing loop 162 


work element queue, location in a VSCS dump 


dispatching priority, performance group 
specification 129 
DISPLAY command 
active traces 208 
buffer pool use 195 
NCP storage 196 
network ID 197 
network resource status 196 
path tables 197 
pending state 197 
route status 198 
route test 205 
status of a logical unit (VSCS) 451 
trace status 208 
DLT trace record 658 
DLT2 trace record 661 
DMS messages, issuing component 146 
documentation for hardware failures 
documentation for terminal hang (VSCS) 164 
documentation problem 108 
documenting problems 48-—55 
DPACE start option of DTIGEN macro 181 
DR 132 
DSC2 trace record 663 
DSCD trace record 662 
DSP trace record 664 
DTI messages, issuing component 146 
DTICO1! message 145 
DTICO2I message 144, 145 
DTICO3I message 148 
DTICO4I message 148 
DTICO5! message with return code 204 146 
DTICO7I message with IPTYPE=03 146 
DTICOSI message 147 
DTIC101 message 173 
DTIGEN macro 
DPACE start option 181 
KPACE start option 181 
PRTSHR start option 185 
specifying start options in 149 
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index 


DTIGEN macro (continued) 
TIMEREL start option 186 
VSAMLM start option 182 

DTIO3I message 148 

DTII04I message 148 

DTIIO6I message 148 

DTIIO71 message 150 

DTIIO8i message 150 

DTIIO9I message 150 

DTII101 message 150 

DTIl111 message 150 

DTIl13l message 150 

DTIl14l message 150, 173 

DTII15I message 148, 150 

DTII16] message 148, 150 

DTINSTRT load module 145 

DTIP15I message 148, 151 

DTIPATCH module 552 

DTIPRBRK trace record (VSCS) 478 

DTIPRBRK trace record, module flow (VSCS) 490 

DTIPRBRK trace record, module-dependent 
(VSCS) 481 

DTIS10! message 181 

DTIS31I1 message 160 

DTIS38I message 148 

DTIS991 message 148, 176 

DTITHDR header (VSCS) 461 

DTIUSERx selected incorrectly 150 

DTIVO1l message 148, 151 

DTIVO4I message 145 

DTIVO7I message 148 

DTIV12I message 181 

DTIVCLSX trace record (VSCS) 519 

DTIVCLSX trace record, module-dependent 
(VSCS) 510 

DTIVDFAX trace record (VSCS) 519 

DTIVDFAX trace record, module-dependent 
(VSCS) 510 

DTIVLOGX trace record (VSCS) 520 

DTIVLOGX trace record, module-dependent 
(VSCS) 511 

DTIVLOSX trace record (VSCS) 521 

DTIVNSEX trace record (VSCS) 521 

DTIVNSEX trace record, module-dependent 
(VSCS) 511 

DTIVOPNX trace record (VSCS) 522 

DTIVOPNX trace record, module-dependent 
(VSCS) 511 

DTIVPURG trace record (VSCS) 478 

DTIVPURG trace record, module flow (VSCS) 490 

DTIVPURG trace record, module-dependent 
(VSCS) 482 

DTIVRECX trace record (VSCS) 524 


DTIVRECX trace record, module-dependent 


(VSCS) 511 
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DTIVRESX trace record (VSCS) 525 
DTIVRESX trace record, module-dependent 
(VSCS) 513 
DTIVRLQX trace record (VSCS) 526 
DTIVRLQX trace record, module-dependent 
(VSCS) 514 | 
DTIVSCIX trace record (VSCS) 528 
DTIVSCIX trace record, module-dependent 
(VSCS) 514 
DTIVSEND trace record: entry 1 (VSCS) 528 
DTIVSEND trace record: entry 2 (VSCS) 532 
DTIVSIML trace record (VSCS) 534 
DTIVSNDxX trace record (VSCS) 526 
DTIVSNDX trace record, module-dependent 
(VSCS) 514 
DTIVTPNX trace record (VSCS) 523 
DTSK trace record 666 
DUMP command 216 
DUMPLU command 451 
dumps 
ABDUMP 232 
analysis of VTAM 237, 241 
communication scanner processor (CSP) 230 
dynamic NCP 227 
first failure support technology (FFST) 217 
formatted dump procedures 245 
IPCS 232 


See also VERBEXIT VTAMMAP, IPCS subcom- 


mand 


maintenance and operator subsystem (MOSS) 231 


MVS 
abend 214 
analyzing with VTAMMAP 240 
first failure support technology (FFST) 217 
formatting and printing 232 
stand-alone 214 
SVC 214 
VTAM control blocks formatted 232 
network control program (NCP) dump _ 
using independent dump utility 230 
using VTAM dump facility 228 
static NCP 228 
tool, dump analysis 237 
enhanced dump analysis tools 240 


tracing execution sequence of VTAM components 


in 552 
VM 
DUMP command 216 
first failure support technology (FFST) 217 
formatting and printing 232 
GDUMP 215 
SDUMP 215 
VMDUMP command 216 
VTAM control blocks formatted 233, 235 
VSE 
DUMP command 217 
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dumps (continued) 
VSE (continued) 
formatting and printing 232 
program-initiated dump 216 
SDAID dump facility 216 
stand-alone dump utility 216 
dynamic 
NCP dump 227 
trace utility 395 


E 


echo test 550 
EDATS (extended data stream feature) 171 
editing done by TPUT options 125 
EIDs (event IDs) 75 
electronic technical report (ETR) 4 
enable SNA_ 144 
ER 132 
ERP trace record 
MVS. 671 
VM_ 667, 668 
VSE 668 
error recording 
hardware 549 
integrated communication adapter lines 556 
intensive mode 210 
LOGREC 50 
NCP 551 
NMVT alerts 539 
SYSREC 51 
error recovery procedures 
trace record 
MVS 671 
VM _ 668 
VSE 668 
ESC option 
VIT trace records created 
ESC 672 
summary 401 
escape character associated with incorrect screen 
size 128 
ETRACE 349, 359 
ETSK trace record 673 
event IDs (EIDs) 75 
exception response mode (ER) 132 
exception responses 122 
execution sequence of VTAM components in a 
dump 552 
exit routines, trace entries for 
IRB 712 
RPL 770 
SRB 793 
TPEXIT 674 
user 804 
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EXIT trace record 674 

EXPN trace record 676 

extended data stream feature (EDATS) 171 
extent of a loop, determining 163 

external trace, VSCS, limiting output 144 


- 


failing module problem 
procedure 109 
failure types 
See problem types 
FBL2 trace record 681 
FBLK trace record 678 
FEATUR2 keyword 171 
FFST 
See First failure support technology (FFST) 
FILEDEFs 414 
FINDDSIB VTAMMAP 256 
finding the PSW_ 90 
FINDSIB VTAMMAP 258 
First failure support technology (FFST) 217 
**** trace record 568 
console 224 
dumps 217 
generic alert 223 
minidump 218 
probes 845 
problems 227 
sample minidump 218, 221 
slip trap 226 
trap module 226 
flows 
APPN 1013 
CP-CP session 1018 
dependent LU server 1098 
directory services 1028 
LU-LU session 1057 
network 925 


deactivation and session termination 976 
dial and answer for X.21 switched lines 1011 
error detection and recovery and SSCP manage- 


ment services 1000 
generic BIND AMRUs_ 930 
resource activation 933 
session establishment 949 
FORCE command 451 
formatted dump procedures 240, 241, 362 
ALL 246 
APPLCONV 248 
APPLMODAL 251 
APPLMODE 249 
APPNBASE 254 
FINDDSIB 256 
FINDSIB 258 
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FNDADJCP 262 
FNDANDCB 263 
FNDCOS 264 
FNDDECB 266 
FNDENDEL 267 
FNDLCB 268 
FNDNDREC 270 
FNDNODE 271 
FNDREREC 273 
FNDSCCB 274 
FNDSITCB 275 
FNDTGREC 277 
HOST 279 
PABSCAN 295 
PARTNRLU 299 
RDTCHECK 300 
RDTFULL 302 
RDTHIER 304 
RDTSUM 305 
ROUTES 306 
SES 308 
SIBCHECK 312 
SPANC 314 
SRTFIND 318 
STORAGE 320 
VITAL 322 
VTAM 323 
VTBASIC 326 
VTBUF 327 
VTCVTPAB 329 
VTFNDMOD 332 
VTMODS 334 
VTNODE 336 
VTREADYQ 338 
VTRPH 339 
VTVIT 340 
VTVRBLK 342 
VTWRE 344 


formatted dump procedures (continued) 


using CPTRAP and TRAPRED 359 


using IPCS 362 


using TPRINT 363 

FRE trace (VSCS) 458 

FREB trace record 506 
FREB trace record (VSCS) 506 
FREEBLK trace record 678 
full-screen 
application, failure symptoms 


169 


description of mode (TSO/VTAM) 122 
incorrect processing (TSO/VTAM) 


full-screen support mode (VSCS) 535 


114 


index 


index 


formatting and printing dump output (MVS, VM) 232 
formatting trace output 
using ACF/TAP 361 
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index 


function codes (VSCS) 
inbound processing in all modes 537 
internal states 536 
outbound processing in CMS mode 538 
outbound processing in console mode 537 
outbound processing in full-screen mode 538 
WEB 535 

function error (TSO/VTAM) 122 


G 


GBL2 trace record 685 
GBLK trace record 682 
GCS (group control system) 
activation 144 
message prefix 146 
GCS ETRACE 349, 359 
GCT messages, issuing component 146 
GDUMP command 215 
generalized PIU trace (GPT) 
description 384 
operation 384 
when to use 384 
generalized trace facility (GTF) 358 
generic alert 223 
GET trace (VSCS) 458 
GETB trace record 507 
GETB trace record (VSCS) 507 
GETBLK trace record 682 
GMSG trace record (VSCS) 476 
GNA2 trace record 687 
GNAM trace record 686 
GPT (generalized PIU trace) 
description 384 
operation 384 
when to use 384 
Greenwich mean time (coordinated universal time) 312 
group control system (GCS) 
activation 144 
message prefix 146 
GTF (generalized trace facility) 358 
GTRACE macroinstruction 349 
GUNBIND pend, cross domain log off 15 


H 
HALT I/O trace record 688 
hang 
documentation for 164 
non-re-creatable 164 
re-creatable 164 
hard-copy log 50 
hardware 
error recording 549 
error records 
LOGREC 50 
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hardware (continued) 
error records (continued) 
SYSREC 51 
problem documentation 49 
HCP messages, issuing component 146 
HCS messages, issuing component 146 
highlighting does not work correctly (VSCS) 171 
HIO trace record 688 | 
HIOP (halt I/O) trace record 690 
hold option, effect on performance 129 
HOLDING condition precedes a hung LU 170 
host IRN (ISTIRN), I/O trace for 374 
host physical unit (ISTPUS) 
buffer contents trace for 371 
/O trace for 374 
HOST VTAMMAP 279 
hung 
LU (VSCS) 
after message DTIC101 173 
after VARY INACT or FORCE command 173 
allLUs hung 161 
during console or CMS mode_ 170 
during full-screen mode 169 
during logoff or disconnect processing 172 
during logon 157 
general procedures to diagnose hung LU prob- 
lems 131 
how to recover 163 
one or more LUs hung 163 
other problems 174 
preliminary procedure 160 
when switching modes. 171 
session 70 
term defined 160 
terminal (TSO/VTAM) 
diagnosis procedure 119 
documentation requirements 119 
symptoms 113 


VO pending 75 
/O trace 
AnyNet trace format for SNA over TCP/IP 376 
description 373 
operation 374 
output for MVS 375 
output for VM 375 
output for VSE 375 
when to use 374 
IBM Support Center 112 
IBMLINK 4 
IBMTEST command (logical unit connection test) 550 
IKJ608I message 113 
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IKTO28I message 113 
IKTO291 message 113 
IMR (intensive mode recording) 210 
inbound processing in all modes (VSCS) 537 
incorrect 
data 
length (TSO/VTAM) 114 
translation (TSO/VTAM) 125 
line prompting (TSO/VTAM) 114 
output 
diagnosis procedure 96 
symptoms 6, 39 
TSO/VTAM 121 
VSCS_ 169, 178 
parameters, VSCS messages issued 149 
processing for a mode (TSO/VTAM) 114 
screen management (TSO/VTAM) 122 
screen size 
diagnosis procedure (TSO/VTAM) 126 
documentation requirements (TSO/VTAM) 126 
due to incorrect logmode (VSCS) 169 
non-SNA 3270 terminal 127 
while dialing to VTAM (VSCS) 184 
increase in 
detected waits 114 
swap-outs 114 
indications of 
full-screen application failure 169 
incorrect logmode definition (VSCS) 169 
OPCHECK 169 
indirect address word structure 898 
initialization 
error messages issued (VSCS) 148 
messages issued (VSCS) 145 
never completes (VSCS) 143 
problems (VSCS) 143 
input is concatenated 123 
input mode processing is incorrect (TSO/VTAM) 114 
input trace record (VSCS) 491 
input/output problem determination (IOPD) facility 209 
INT trace records 
MVS 693 
VM_ 692, 695, 701 
VSE 692, 698 
INT2 trace records 694, 697, 700 
integrated communication adapter lines, error recording 
for 556 
intensive mode recording (IMR) 210 
inter-user communication vehicle (IUCV) 
option card, user !ID for 143 
pacing problem 181 
interactive problem control subsystem (IPCS) 
See VERBEXIT VTAMMAP, IPCS subcommand 
intermediate routing node (IRN), I/O trace of 374 
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internal errors (VSCS) 176 
internal mode (VSCS) 535 
internal states, function codes for (VSCS) 536 
internal trace table location 
VSCS 
inadump 162 
in storage 162 
VTAM 
inadump 403 
in storage 402 
interpreting SVC trace entries 113 
INTR trace record (VSCS) 489 
lO1 trace record 703 
lO2 trace record 
MVS 705 
VM 706 
VSE 705 
lO3 trace record 
MVS 707 
VM 708 
VSE 707 
lIOPD (input/output problem determination) facility 209 
IPC trace record 709 
IPCS (interactive problem control subsystem) 
See VERBEXIT VTAMMAP, IPCS subcommand 
IPCS panel, customize 240 
IPI trace record 710 
IPTYPEs 
complete list 147 
source of in VSCS messages 146 
IRBD trace record 711 
IRBX trace record 712 
IRN, trace of (host) 374 
IST messages 
See also messages 
issuing component 146 
ISTCOCxx FFST probes 848 
ISTCSCxx FFST probes 847 
ISTDRCxx FFST probes 852 
ISTFSCxx FFST probes 849 
ISTIPCxx FFST probes 859 
ISTMTCxx FFST probes 860 
ISTNACxx FFST probes 861 
ISTNSCxx FFST probes 860 
ISTORCxx FFST probes 869 
ISTPATCH module 551 
ISTPUS (host physical unit) 
buffer contents trace for 371 
I/O trace for 374 
ISTPUS in traces 
buffer trace 371 
/O trace 374 
ISTRACxx FFST probes 870 
ISTSCCxx FFST probes 861 
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index 


ISTSLCxx FFST probes 863 
ISTSSCxx FFST probes 861 
ISTTRCxx FFST probes 869 
ISTTSCPF 7 
ISTTSCxx FFST probes 870 
ISTVABND VTAMMAP_ 280 
ISTVDUMP VTAMMAP 283 
ISTVMAP VTAMMAP 286 
ISTVSAVE VTAMMAP 288 
ISTVSLIP VTAMMAP 291 
IUCV (inter-user communication vehicle) 
option card, user ID for 143 
pacing problem 181 


J 


JOBN trace field 367 


K 


keyboard 
character functions improperly 123 
locked 169 

KPACE start option of DTIGEN macro 181 


L 


large pageable buffer pool (LPBUF) 
VM_ 838 
VSE 841 
LBCSTATE values (VSCS) 
CMS edit mode 535 
console mode 535 
full-screen support mode 535 
_ internal mode 535 
LCS option 
VIT trace records created 
LCS2 717 
LCSL 713 
LCSM 718 
LCSP 713 
LCSS 713 
LCSX 713 
LCS2 trace record 717 
LCSL trace record 713 
LCSM trace record 718 
LCSP trace record 713 
LCSS trace record 713 
LCSX trace record 713 
library, VTAM definition 52 
licensing agreement xxxvil 
LIC! (LAN interface control) trace record 720 
LICO (LAN interface control) trace record 720 
LICS (LAN interface control) trace record 720 
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LIER trace record (VSCS) 477 | 
limiting amount of VSCS external trace output 144 
line delete key functions improperly 123 
line mode, description (TSO/VTAM) 122 
line trace 
description 385 
operation 386 
record format 
communication scanner type 2 386 
communication scanner type 3 388 
when to use 385 
link level 2 (LL2) test 49, 211 
link pack area (LPA) map 50 
link-edit (XREF) map 50 
LKEX trace record 723 
LKSH trace record 724 
LL2 (link level 2) test 49, 211 
LNKA trace record 725 
LNKI trace record 725 
LNKL trace record 725 
LNKx trace record 725 
local SNA terminals, pacing values for 
(TSO/VTAM) 129 
location of 
BIND 127 
current entry in VSCS internal trace table 162 
dispatcher work element queue in a VSCS 
dump 163 
registers ina VSCS dump 144 
VSCS internal trace table 
inadump 162 
in storage 162 
LOCK option 
VIT trace records created 
LKEX 723 
LKSH 724 
summary 401 
ULKA 808 
UNLK 809 
locked queue anchor block (LQAB) 75 
locks, description of 80 
log of console 52 
logical unit (LU) 
connection to other components (VSCS) 172 
control blocks TAB, PLB, and VLB_ 161 
disconnected (VSCS) 169 
hangs 
after you receive message DTIC101 173 
in console mode or CMS mode_ 170 
in full-screen mode or when the LU is dialed 169 
other reasons for hangs 174 
PNFYx state 8 
stays hung after VARY INACT or FORCE 
command 173 
when you logoff or disconnect 172 
when you switch modes 171 
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logical unit (LU) (continued) 
recovery (VSCS) 173 
logical unit connection test (IBMTEST) 550 
logmode 
default name in USS command 127 
incorrectly defined, symptoms (VSCS) 169 
table entry in DLOGMOD 115 
logoff problems (VSCS) 159, 172 
logon problems 
CICS 17 
TSO/VTAM 
ABENDOAB 117 
cross-domain network 116 
diagnosis procedure 114 
documentation requirements 114, 129 
fails for all terminals 116 
symptoms 113 
VSCS_ 157 
LOGREC error recording data set 50 
loop problems 
diagnosis procedure 86 
symptoms 6, 39 
VSCS 
determining extent 163 
diagnosis procedure 159 
during initialization 148 
symptoms 162 
verifying 162 
loss of operator communications 173 
LOST trace record 727 
LPA (link pack area) map 50 
LPBUF, finding 
VM_ 838 
VSE 841 
LPDA-2 
network flows 1003, 1004, 1005 
LQAB control blocks 75 
LSN2 trace record 730 
LSNA trace record 728 
LU (logical unit) 
connection to other components (VSCS) 172 
control blocks TAB, PLB, and VLB_ 161 
disconnected (VSCS) 169 
hangs 
after you receive message DTIC10I 173 
in console mode or CMS mode_ 170 
in full-screen mode or when the LU is dialed 169 
other reasons for hangs 174 
PNFYx state 8 
stays hung after VARY INACT or FORCE 
command 173 
when you logoff or disconnect 172 
when you switch modes_ 171 
recovery (VSCS) 173 
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LU 6.2 message unit 740, 743 

LU-related problems, VSCS 
3279 color terminal 171 
after message DTIC101 173 
after VARY INACT or FORCE command 173 
allLUs are hung 161 
color terminal (3279) 171 
disconnected 169 
during console or CMS mode_ 170 
during full-screen mode 169 
during logoff or disconnect processing 172 
during logon 157 
highlighting does not work correctly 171 
logoff and disconnect problems 159 
LU type 1 170 
one or more LUs hung 163 
other problems 174 
preliminary procedure for 160 
premature termination of user's session 153 
Presentation Services loop causes hang 162 
printer sharing 185 
screen size is wrong 184 
SNA dial 184 
user exits 170 
when switching modes. 171 


Maintain System History Program linkage editor 50 
maintenance and operator subsystem (MOSS) 
dump 231 
MAXDATA value, how to specify 123 
MDR (miscellaneous data record) 549 
Message Sent trace record 738 
messages 
‘NOT ACCEPTED’ 169 
issued for 3745 bus switching 549 
IST12781 39, 209 
ACTLINK PENDING 8 
GUNBIND PENDING 15 
NMVT PENDING 16 
IST2591 9 
IST4001 116 
IST4891 14 
IST5301 16 
IST7181 18 
IST7191 18 
IST8041 116 
IST805I 116 
limit is reached 169 
module identification, modify 210 
prefixes 146 
problem 
procedure 93 
symptoms 6, 39 
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messages (continued) 
TSO/VTAM 
logon problems 113 
VSCS 
initialization, normal 145 
initialization, problems 148 
issued by Presentation Services 176 
issued by System Services 177 
issued by VTAM Services 176 
parameter problem 149 
problems 176 
source of return codes 146, 172 
MIC trace record 731 
MIE trace record 732 
Mil trace record 733 
miscellaneous data record (MDR) 549 
misplaced data 
See incorrect 
mode switching errors (TSO/VTAM) 114 
MODEENT macro, description 115 
modified data tags 123 
MODIFY command 
dump 228 
IOPD 209 : 
lIOMSGLIM start option, effect on IOPD 
facility 209 
message module identification 210 
MSGMOD 210 
NCP intensive mode recording 210 
SDLC link level 2 test 211 
trace 349 
tuning statistics 212 
VTAMOPTS 212 
module levels, determining VSCS 136 
module name 
finding ina dump 61 
finding in an internal trace (VIT) 405 
MORE condition precedes a hung LU 170 
MOSS dump 231 
MPT trace record 734 
MPT2 trace record 735 
MSG option 
VIT trace records created 
MSG 736 
MSG2 739 
MSGS 738 
OPE2 753 
OPER 752 
summary 401 
MSG trace record 736 
MSG2 trace record 739 
MSGS trace record 738 
MSGS trace record (VSCS) 500 
MSHP linkage editor 50 
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MUS trace record 
MU4 trace record 
MVS 

dumps 


abend 214 
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740 
743 
744 
746 


formatting and printing 232 
stand-alone 214 


SVC 214 


VTAM control blocks formatted 232, 235 
performance group specification 129 
trace fields 367 


N 


NCP (Network Control Program) 


dumps 


dynamic 227 
independent dump utility 230 


static 228 


VTAM dump facility 228 
error recording 551 
_ intensive mode recording 210 
storage, displaying 196 


traces 


dynamic trace utility 9395 
generalized PIU (GPT) 384 


line 385 


network controller line 389 
scanner interface (SIT) 390 
transmission group (TG) 391 


NetView program 
file 51 


for hardware failure 49 
hard-copy log 50 
NetView session trace 353 
Network Control Program (NCP) 


dumps 


dynamic 227 
independent dump utility 230 


static 228 


VTAM dump facility 228 
error recording 551 
intensive mode recording 210 
storage, displaying 196 


traces 


dynamic trace utility 395 
generalized PIU (GPT) 384 


line 9385 


network controller line 389 

scanner interface (SIT) 390 

transmission group (TG) 391 
network controller line trace 


operation 389 
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network controller line trace (continued) 
output 390 
when to use 389 
network flows 
See flows 
network status, displaying 196 
NMP2 trace record 748 
NMPT trace record 747 
NMVT alerts 
error recording 539 
non-re-creatable hang 
getting dump documentation for 167 
getting trace documentation for 167 
non-SNA 3270 terminal, incorrect screen size 127 
NOT ACCEPTED message 169, 170 
NRM option 
VIT trace records created 
BSPx 598 
BSSx 599 
BSXx 600 
PROA 760 
PROD 760 
RCEx 767 
SRT2 795 
SRTA 794 
SRTC 794 
SRTD 794 
SRTF 794 
SRTx 794 | 
NRS2 trace record 750 
NRSP trace record 749 — 
NSD trace record 751 
NVPACE operand (TSO/VTAM) 129 


O 


OBR (outboard recorder) record 549 
OPCHECK symptoms 169 
OPE2 trace record 753 
OPER trace (VSCS) 458 
records 500 
OPER trace record 752 
OPER trace record (VSCS) 501 
operation checks 113 
operation codes, CPCB 1127 
operator | 
commands processed incorrectly (VSCS) 187 
console cannot communicate with VSCS 173 
operator commands are rejected (VSCS) 187 
operator commands do not complete (VSCS) 175 
operator commands 
BFRFIFO (VSCS) 450 
CHANGE (VSCS) 450 
DISPLAY 193, 451 
DUMPLU (VSCS) 451 
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operator commands (continued) 
FORCE (VSCS) 451 
MODIFY 193 
QUERY (VSCS) 451 
STORAGE (VSCS) 452 
operator trace (VSCS) 458 
option, TPUT, location of 124 
outboard recorder (OBR) record 549 
outbound processing in CMS mode (VSCS) 538 
outbound processing in console mode (VSCS) 537 
outbound processing in full-screen mode (VSCS) 538 
output 
problems 
TSO/VTAM_ 121 
VSCS_ 178 
wait condition 129 
output trace record (VSCS) 491 
overview of normal VSCS initialization 141 


p 
PAB DISPATCH trace record 664 
PABs (process anchor blocks) 73 
PABSCAN VTAMMAP 295 
pacing 

lUCV 181 

values for local SNA terminals (TSO/VTAM) 129 
PALNK status 8 
panel interface, using the 242 
parameters 

error messages (VSCS) 149 

specifying in DTIGEN macro 149 
patch area 

TSO/NVTAM_ 552 

VSCS 552 

VTAM 551 
path problems, example solution 199 
path tables, display of 197 
PDDB, problem determination database 5 
pending state, display of resources in 197 
performance group 

how to specify 129 

location of 129 
performance problem 

diagnosis procedure 101, 129 

symptoms 6, 39 

TSO/VTAM 114 

VSCS 182 
PFOR trace record (VSCS) 483 
PIC (packet interface) trace record 754 
PIU discard reason codes 1141 
PIU discards, probable causes 1154 
PIU option 

VIT trace records created 

DSC2 663 
DSCD 662 


Index 1181 


index 


PIU option (continued) 
VIT trace records created (continued) 
~ NRS2 750 
NRSP 749 
PIU 755 
PIU2 756 
summary 401. 
PIU too long 123 
PIU trace record 755 
PIU2 trace record 756 
PKTI (packet) trace record 757 
PKTO (packet) trace record 757 
PKTX (packet extension) trace record 758 
PLB control block 161 
PLBINxx, LBCSTATE values for (VSCS) 535 
PNFYx state 8 
POST trace record 759 
premature termination 
of VSCS 151 
of VSCS user’ session 153 
Presentation Services 
large enabled loop 162 
messages issued by 176 
primary screen size, PSERVIC coding for 127 
printer 
commands for accessing (VSCS) 185 
not released (VSCS) 186 
sharing problems (VSCS) 185 
PRINTER command causes VTAM SIMLOGON 
failure 185 
printer LU, determining the status of VSCS 138 
printing output 
dumps 
using ABDUMP. (MVS) 232 
using IPCS (VM) 233, 235 
using PRTDUMP (VM) 233 
using SADMP (MVS) 235 
using SDUMP (VM) 235 
traces 


3705, 3720, 3725, or 3745 SMS line trace 386 


using ACF/TAP 361 
using CPTRAP and TRAPRED 359 
using IPCS 362 
using TPRINT 363 
PROA trace record 760 
problem determination commands 
DISPLAY 
buffer pool use 195 
NCP storage 196 
network status 196 
path tables 197 
pending state 197 
route status 198 
route test 205 
traces 208 
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problem determination commands (continued) 
MODIFY 
intensive mode recording 210 
lOPD 209 
link level 2 test 211 
message module identification 210 
tuning statistics 212 
problem determination database (PDDB) 5 
problem documentation 48 
problem solving tools 
alert messages 539 
APPN_ 555 
error recording for communication adapter lines 556 
hardware error recording 549 
IPCS 232 
logical unit connection test (IBMTEST) 550 
messages for 3745 bus switching 549 
NCP error recording 551 
NCP intensive mode recording 210 
patch area 551 
recording NMVT alerts in LOGREC 539 
save area module linkage conventions 
subarea 552 
problem types 
abend (abnormal end) 58 
documentation 108 
failing module 109 
incorrect output 96 
loop 86 
message 93 
path, example solution 199 
performance 101 
program check 63 
storage 105 
VTAM vs. non-VTAM 4 
wait 67 
DSRLIST 17 
process anchor blocks (PABs) 73 
process scheduling table (PST) 72 
processing is hung (TSO/VTAM) 113 
PROD trace record 760 
profile add 760 
profile delete 760 
program 
check 
after message DTIC10! 173 
diagnosis procedure 63 
symptoms 39 
temporary fix (PTF) 51 
update tape (PUT) 51 
program temporary fix (PTF) eyecatcher 51 
program-initiated dump 216 
PROGxxx message 
TSONVTAM 113 
VSCS 169 
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PRTDUMP utility 233 
PRTSHR start option of DTIGEN macro 185 
PSS option 
VIT trace records created 
ADSP 584 
ATSK 595 
AXIT 597 
BTSK 601 
DSP 664 
DTSK 666 
ETSK 673 
EXIT 674 
IRBD 711 
IRBX 712 
POST 759 
QUE 763 
QUEN 765 
RESM 777 
SCHD 779 
SRBD 792 
SRBX 793 
summary 401 
VPST 824 
VRSM 825 
VWAI 829 
WAIT 830 
XPST 834 
_ PST (process scheduling table) 72 
PTF (program temporary fix) eyecatcher 51 
PVM (pass-through VM virtual machine) 184 


Q 


QREQ trace record 761 

QRYL trace record 762 

QUE trace record 763 

QUEN trace record 765 

QUERY command 451 

query language VIT entry 762 
QUEUED REQSTORE trace record 774 


R 


RACR trace record 766 
RCE trace record 767 
RDS2 trace record 769 
RDSC trace record 768 
RE trace record 770 
re-creatable hang 
getting dump documentation for 166 
getting trace documentation for 164 
RECMS (record management statistics) 10 
record management statistics (RECMS) 10 
recovering an LU (VSCS) 173 
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registers, location ina dump (VSCS) 144 
releasing a printer (VSCS) 186 
releasing VSCS LU 173 
RELS trace record 772 
repeated error record entries 

LOGREC 90 

SYSREC 90 
reporting problems procedure 112 
REQ2 trace record 776 
REQS trace record 774 
request parameter header (RPH) 

finding 79 

waiting 79 
reshow processing, description 122, 124 
RESM trace record 777 
response time slow (TSO/VTAM) 114 
RETRACE listing 50 
return codes 

RPL6 226 

source (VSCS) 146, 172 
REXX exec for VIT analysis tool 413, 414 
route 

status, display 198 

test, display 205 
RPH (request parameter header) 

finding 79 

waiting 79 
RPL EXIT trace record 770 


Index 


RPL request type, location in dump of SDWA_ 118 


RPL6 return code 226 

RPLFDB2, location in dump of SDWA_ 118 
RPLFDBK2, location in dump of SDWA_ 118 
RPLRTNCD, location in dump of SOWA 118 


S 


sample procedures 242 
save area 
loop extent shown in 163 
module linkage conventions, APPN 555 
module linkage conventions, subarea 552 
SAW data, filtering 16 
scanner interface trace (SIT) 
description 390 
operation 390 
when to use 390 
SCHD trace record 779 
SCNT trace record (VSCS) 477 
screen management problems, TSO/VTAM 
diagnosis procedure 121 
documentation 121 
symptoms 113 
types 121 
screen size 
changing, in non-full-screen processing 127 


Index 
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screen size (continued) 
default value 127 | 
problems 
TSO/VTAM 124, 126 
VSCS_ 169, 184 
PSERVIC coding. 127 
TSO/VTAM problems 114 
SCRSIZE operand 127 
SDAID dump facility 216 
SDLC link level 2 test, modify 211 
SDUMP utility 215 
SDWA (system diagnostic work area) 51 
sense codes 
0801 20 
081C 21 
0821 23 
0835 23 
800A 24 
APPC 226 
sense data 
in I/O trace | 
MVS and VM_ 375 
VSE 376 
in transmission group trace 
MVS and VM_ 393 
VSE 394 
service aids, diagnosis tools 
alert messages 539 
APPN 555 
error recording for communication adapter lines 556 
hardware error recording 549 
IPCS 232 
logical unit connection test (IBMTEST) 550 
messages for 3745 bus switching 549 
NCP error recording 551 
NCP intensive mode recording 210 
patch area 551 
recording NMVT alerts in LOGREC 539 
save area module linkage conventions 
subarea 552 
session 
awareness (SAW) data 51 
ending unexpectedly 10 
parameters, defining (TSO/VTAM) 115 
trace data 51 
session awareness data, filtering 16 
SEVR trace record (VSCS) 478 
SIBCHECK VTAMMAP_ 312 
SIMLOGON fails after PRINTER command 
(VSCS) 185 
SIO trace record 
MVS 782 
VM_ 781, 782, 784 
VSE 781, 782 
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$lO2 trace record 
MVS 784 
VSE 784 
SIT (scanner interface trace) 
description 390 
operation 390 
when to use 390 
slip trap 226. 
slow response time 
general procedure 101 
TSO/VTAM 114 
VSCS_ 182 
SMS (buffer use) trace 
description 377 
format 
MVS 378 
VM 378 
VSE 379 
operation 378 
when to use 377 
SMS option 
VIT trace records created 
AREL 594 
EXPN 676 
FBL2 681 
FBLK 678 
GBL2 685 
GBLK 682 
QREQ 761 
RELS 772 
REQ2 776 
REQS 774 
summary 401 
VTAL 826 
VTFR 828 
SNA 
dial problems (VSCS) 184 
enable 144 
terminals, local, pacing values for (TSO/VTAM) 129 
SNAP 
abend 569 
trace record, VIT 408 
SNAPREQ start option 104 


SOCA trace record 788 


SOCD trace record 788 
SOCF trace record 788 
SOCR trace record 788 
SOCx trace record 788 
solving problems, where to begin 3 
source of IPTYPEs and return codes in VSCS mes- 
sages 146, 172 
source of messages 
DMS 146 
DT| 146 
GCT 146 
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source of messages (continued) SSCP option (continued) 
HCP 146 VIT trace records created (continued) 
IST 146 DLT2 661 
SPANC VTAMMAP 314 summary 401 
SPT trace record 789 TGM 796 
SPT2 trace record 791 TGM2 798 
SRBD trace record 792 TREB 799 
SRBX trace record 793 TRED 799 
SRT2 trace record 795 TRE! 799 
SRTA trace record 794 TREM 799 
SRTC trace record 794 stand-alone dump 
SRTD trace record 794 MVS 214 
SRTF trace record 794 VSE 216 
SRTx trace record 794 START command, using to activate VTAM traces 349 
SSCP option starting address of the VSCS internal trace 
VIT trace records created table 162 
A2forCP 593 START I/O trace record 
ACRC 578 MVS 782, 784 
ACSN 579 VM 781, 782, 784, 786 
ALS 589 VSE 781, 782, 784, 786 
AP forCP 591 STAT trace (VSCS) 458 
CC2 for NCSPL 605 record 502 
CC2 for RUPE 603 STAT trace record (VSCS) 502 
CCl for NCSPL 604 static NCP dump 228 
CCl for RUPE 602 status, display of 196 
CCl, not RUPE or NCSPL_ 606 STDLCxx FFST probes 851 
CCO forNCSPL 604 storage and control block ID codes 1137 
CCO for RUPE 602 storage problem 19, 105 
CCO, not RUPE or NCSPL_ 606 storage statistics (STAT) trace (VSCS) 458 
Cli 625 storage, VSCS | 
Cl2 628 available, determining amount 149 
Ci3 631 problems 152, 179 
Cl4 632 records 507 
COi 625 STORAGE command 452 
CO2 628 storage statistics (STAT) trace (VSCS) 
CO3 631 record 502 
CO4 632 storage trace (VSCS) 
CPP2 643 FREB trace record 506 
CPP3 644 GETB trace record 507 
CPP4 645 STSIZE macro, changing screen size with 127 
CPPG 641 Support Center 112 
CPPT 641 SVC dump 214 
CPR2 647 swap count, incorrect incrementing 129 
CPR3 648 swap-outs increase 114 
CPRC 646 symptom string ° 
CPW2 651 description 51 
CPW3 652 MVS 59 
CPW4 653 structure 111 
CPWT 650 VM 59 
CRA add 654 VSE 64 
CRD delete 654 symptoms 
CRF find 654 &I2@E5. 
DBD delete 656 | in TSO/VTAM 119 
DBQ query 656 abend 6, 58 
DBU update 656 in TSO/VTAM_ 117 


DLT 658 inVSCS 162 
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symptoms (continued) 
documentation problem 108 
full-screen application failure 169 
hung terminal 160 
incorrect logmode definition 169 
incorrect output 96 
initialization problem (VSCS) 141 
logon problem 
in TSO/VTAM 114 
inVSCS 141 
loop problem 86 
message problem 93 
inVSCS 141 
OPCHECK 169 
performance problem 101 
in TSO/VVTAM 114 
inVSCS 141 
printer sharing problem (VSCS) 141 
program check 40, 63 
screen management problems 113 
screen size problems 114 
SNA dial problem 141 
storage problem 105 
termination problem (VSCS) 141 
wait problem 67 
invVSCS 141 
syntax diagrams, reading 238 
SYS1.LOGREC error recording data set 50 
SYSREC error recording data set 51 
system diagnostic work area (SDWA) 51 
System Services, messages issued by 177 


T 
TAB control block 161 
TAP (trace analysis program) 361 
tape 
3480, documentation 50 
3490, documentation 50 
TCP option 
VIT trace records created 
IPC 709 
IPI 710 
MIC 731 
MIE 732 
Mil 733 
MPT 734 
MPT2 735 
NMP2 748 
NMPT 747 
SOCA 788 
SOCD 788 
SOCF 788 
SOCR 788 
SOCx 788 
summary 401 
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techniques to recover a hung LU (VSCS) 163 
terminal 
cannot log on 114, 157 
definition statement 115 
device problem 89, 98 
hung 
in TSO/VTAM 119 
inVSCS 161, 163 
incorrect output problem 127, 178 
name, location in dump of SDWA_ 117 
pacing values 129 
recovery when hung 163 
user echo test 550 
termination 
TSO/VTAM 
abend 117 
during logon 114 
VSCS 
abend 152 
immediately upon starting 145 
never completes 151 
premature 151 


unexpectedly, via operator command 154 


user's session 153 

TG (transmission group) trace 

description 391 

operation 391 

output for MVS 392 

output for VM 392 

output for VSE 394 

when to use 391 
TGET/TPUT trace 

See TSO/VTAM TGET/TPUT trace 
TGM trace record 796 
TGM2 trace record 798 
TIMEREL start option of DTIGEN macro 186 
TNSTAT (tuning statistics), modify 212 
TPESC trace record 672 
TPEXIT trace record 674 
TPIO trace record 703 
TPLOCK EXCLUSIVE trace record 723 
TPLOCK SHARED trace record 724 
TPMSG trace record 736 
TPPOST trace record 759 
TPQUE NONE trace record 765 
TPQUE trace record 763 
TPRINT utility 363 
TPSCHED trace record 779 
TPSWPST trace record 834 
TPUNLOCK ALL trace record 808 
TPUNLOCK trace record 809 
TPUT option 

editing 125 

location 124 
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trace analysis program 361 


See also ACF/TAP (trace analysis program) 


trace entries 
adapter 582, 583 
ClO error recovery 667 
halt /O 690 
interrupt 692, 701 
LAN channel station control 713 
LAN interface control 720 
packet 757 
packet extension 758 
packet interface 754 
start /O 781, 782, 784, 786 
TRACERED 
formatting and printing 361 
sample output 465 
with VIT analysis tool 412 
traces 
activating 349 
analysis program (ACF/TAP) 361 
buffer contents 369 
buffer use (SMS) 377 
CCW 98, 351 
component execution sequence 552 
dynamic trace utility 9395 
fields 
MVS-only 367 
VM-only 367 
generalized PIU (GPT) 384 
VO 373 
internal (VIT) 397 
line 9385 
network controller line 389 
printing 
CPTRAP 359 
IPCS 362 
TPRINT 363 
records, VIT 567 
scanner interface (SIT) 390 
SMS (buffer use) 377 
table header record (VIT) 402 
TGET/TPUT, for TSO/VTAM 380 
tool, VIT analysis 411 
transmission group (TG) 391 
using 347 
tracing, virtual machine 360 
trademarks xxxviii 
translate message VIT entry 801 
translation 
incorrect (TSO/VTAM) 125 
tables (TSO/VTAM) 126 
transmission group (TG) trace 
description 391 
operation 391 
output for MVS 392 
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transmission group (TG) trace (continued) 
output for VM 392 
output for VSE 394 
when to use 391 
trap module, using the 226 
TRASIZE start option of DTIGEN macro 131 
TREB trace record 799 
TRED trace record 799 
TREI trace record 799 
TREM trace record 799 
TRN2 trace record 803 
TRNM trace record 801 
TRSAVE 359—360 
TRSOURCE 359—360 
TSO EDIT problems 114 
TSO TERMINAL command, changing screen size 
with 127 
TSO/VTAM problems 
ABENDOAB 117 
ABENDOAC 118 
ABENDOAD 119 
ABEND15D 119 
data misplaced on screen 124 
data translated incorrectly 125 
exception responses 122 
extra data 123 
first logon from a particular device fails 115 
first logon using USS commands fails 114 
function error 122 
hung terminal 119 
incorrect data translation 125 
incorrect screen size 126 
initial TSO/VTAM problem analysis 113 
logon fails 9, 114 
misplaced data on screen 124 
missing data 123 


mode error (incorrect screen management) 122 


performance 129 
response time is slow 114 
screen is always wrong size 126 
screen is wrong size for mode 127 
screen management 121 
TGET, partial input for 20 
translation of data 125 

TSO/VTAM TGET/TPUT trace 
description 380 
operation 381 
output 381 
when to use 380 

tuning 129 

tuning statistics (TNSTAT), modify 212 
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UE trace record 804 
UE1 trace record 805 
UE2 trace record 807 
ULKA trace record 808 
UNLK trace record 809 
UP trace record 810 
user cannot log on TSO/VTAM 114 
user edit exits 
TSO/VTAM 
when to use 125 
where to find description of 124 
where to find list of 126 
VSCS_ 170 
USER EXIT trace record 804 
user ID for |\UCV option card 143 
USER POST trace record 810 
USRxx trace field 367 
USS commands used in logon 114 
USS message 10 113 
USS message 7 113 
utility 53 
IEBGENER 53 
restriction, dumps 53 


V 


VARY INACT,FORCE command 83 
VCC1 trace record 812 
VCC2 trace record 814 
VCDQ trace record 815 
VCNS option 
VIT trace records created 
CNA 633 
CNP1 636 
CNP2 638 
CNP3S 639 
CNR1 636 
CNR2 638 
CNR3 639 
NSD 751 
summary 401 
VCC1i 812 
VCC2 814 
VCDQ_ 815 
VCP1 819 
VCP2 823 
VCP1 trace record 819 
VCP2 trace record 823 
VERBEXIT VTAMMAP, IPCS subcommand 240, 241, 
362 
ALL 246 
APPLCONV 248 
APPLMODAL 251 
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VERBEXIT VTAMMAP, IPCS subcommand (continued) 
APPLMODE 249 
APPNBASE 254 
FINDDSIB 256 
FINDSIB 258 
FNDADJCP 262 
FNDANDCB 263 
FNDCOS 264 
FNDDECB 266 
FNDENDEL 267 
FNDLCB 268 
FNDNDREC 270 
FNDNODE 271 
FNDREREC 273 
FNDSCCB 274 
FNDSITCB 275 
FNDTGREC 277 
HOST 279 
PABSCAN 295 
PARTNRLU 299 
RDTCHECK 300 
RDTFULL 302 
RDTHIER 304 
RDTSUM 305 
ROUTES 306 
SES 308 
SIBCHECK 312 
SPANC 314 
SRTFIND 318 
STORAGE 320 
VITAL 322 
VTAM 323 
VTBASIC 326 
VTBUF 327 
VTCVTPAB 329 
VTFNDMOD- 332 
VTMODS 334 
VTNODE 336 
VTREADYQ 338 
VTRPH 339 
VTVIT 340 
VTVRBLK 342 
VTWRE 344 

verifying aloop (VSCS) 162 

virtual machine tracing 360 

Virtual Telecommunications Access Method (VTAM) 
See VTAM 

VIT 
See VTAM internal trace (VIT) 

VIT analysis tool 411, 42, 411 
data set, required to run 412 
I/O options 445 
interactive VIT analysis 413 
job parameters 415 
job submission 415 
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VIT analysis tool (continued) VSCS (continued) 


output, checking 416 

parameter dataset, creating 447 
restrictions, operating 416 
REXX exec 413, 414 

timing options 442 

VIT recording 412 


VLB control block 161 
VM 


directory, user ID for IUCV option card 143 
dumps 

DUMP command 216 

formatting and printing 232 

GDUMP 215 

SDUMP 215 

VMDUMP command 216 

VTAM control blocks formatted 233 
logo problems on an SNA device 154 
trace fields 367 


VMDUMP command 216 

VPST trace record 824 

VRSM trace record 825 

VSAMLM start option of DTIGEN macro 182 
VSCS 


control block ID codes 1139 
initialization 
components involved 142 
does not complete 143 
loops 148 
messages indicating problems 148 
messages showing success 145 
other initialization problems 149 
source of IPTYPEs and return codes in 
messages 146 
terminates immediately upon starting 145 
internal problems 176 
internal trace table 
location ina dump 162 
location in storage 162 
message prefix 146 
messages, source of return codes 148, 172 
operational differences between VSCS and CP 139 
overview of normal initialization 141 
PRINTER command causes VTAM SIMLOGON 
failure 185 
problems 
abends 152 
allLUs hung 161 
change command, not working 183 
device characteristics, determining 135 
disconnect 159 
documentation requirements 131 
general procedures to diagnose hung LU prob- 
lems 131 
incorrect output 178 
incorrect parameters, messages for 149 
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IUCV pacing 181 
logoff 159 
logon 157 
loop 159 
loop during initialization 148 
LU hangs after message DTIC10! 173 
LU hangs during console or CMS mode_ 170 
LU hangs during full-screen mode 169 
LU hangs during logoff or disconnect 
processing 172 
LU hangs when you switch modes 171 
LU stays hung after VARY INACT or FORCE 
command 173 
message 141 
misspelled or missing parameters 143 
module levels, determining 136 
one or more LUs hung 163 
operator command does not complete 175 
operator command is rejected 187 
performance 182 
premature termination of user's session 153 
premature termination of VSCS_ 151 
Presentation Services in large enabled loop 162 
printer LU, determining the status of 138 
printer sharing 185 
screen size is incorrect 184 
SNA dial 184 
storage 179 
storage shortage 143, 152 
symptoms 141 
termination 150 
termination immediately upon starting 145 
wait 159 
restrictions 139 
storage available, determining amount 149 
storage ID codes 1139 
termination messages 150 
termination problems 
incomplete termination 151 
operator commands terminate VSCS 
unexpectedly 154 
other termination problems 154 
premature termination 151 
user's session terminates prematurely 153 
trace records 
ABND 488 
ACNT 472 
CCS data 472 
CCS record foranLU 467 
CCS, global 470 
CMSG 473 
CNCT 474 
CXIT 486 
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VSCS (continued) 
trace records (continued) 
dispatcher record for an LU: entry 1 492 
dispatcher record for an LU: entry 2 495 
dispatcher record, global 497 
DTIPRBRK 478 
DTIPRBRK, module trace flow 490 
DTIPRBRK, module-dependent 481 
DTITHDR header 461 
DTIVCLSX 519 
DTIVCLSX, module-dependent 510 
DTIVDFAX 519 
DTIVDFAX, module-dependent 510 
DTIVLOGX 520 
DTIVLOGX, module-dependent 511 
DTIVLOSX 521 
DTIVNSEX 521 
DTIVNSEX, module-dependent 511 
DTIVOPNX 522 
DTIVOPNX, module-dependent 511 
DTIVPURG 478 
DTIVPURG, module trace flow 490 
DTIVPURG, module-dependent 482 
DTIVRECX 524 
DTIVRECX, module-dependent 511 
DTIVRESX 525 
DTIVRESX, module-dependent 513 
DTIVRLQX 526 
DTIVRLQX, module-dependent 514 
DTIVSCIX 528 
DTIVSCIX, module-dependent 514 
DTIVSEND: entry 1 528 
DTIVSEND: entry 2 532 
DTIVSIML 534 
DTIVSNDX 526 
DTIVSNDX, module-dependent 514 
DTIVTPNX 523 
FREB 506 
GETB 507 
GMSG 476 
input 491 
INTR 489 
LIER 477 
MSGS _ 500 
OPER 501 
output 491 
PFOR 483 
SCNT 477 
SEVR 478 
STAT 502 
VTAM exit data 519 
VTAM exit data, module-dependent 510 
VTAM exit: entry 1 508 
VTAM exit: entry 2 515 
traces 

cleanup trace 458 
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VSCS (continued) 


traces (continued) 

console communication services (CCS) 
trace 131, 458 

data (DAT) trace 458 
dispatcher (DISP) trace 458 
FRE trace 458 
GET trace 458 
operator (OPER) trace 458 
storage statistics (STAT) trace 458 
storage trace (FRE and GET) 458 
VTAM exit trace 131, 458 


VSE 


dumps 
DUMP command 217 
formatting and printing 232 
program-initiated dump 216 
SDAID dump facility 216 
stand-alone dump utility 216 


VTAL trace record 826 
VTAM 


buffer pool use 377 
buffer pools, finding 837 
channel programs 873 
commands for problem determination 193 
control block ID codes 1137 
control blocks formatted in a dump 
MVS 232 
VM 233, 235 
definition library 52 
dump analysis, using IPCS VTAMMAPs_ 237, 241 
dump facility 228 
execution sequences 552 
exit trace data (VSCS) 519 
exit trace data, module-dependent (VSCS) 510 
exit trace: entry 1 (VSCS) 508 
exit trace: entry 2 (VSCS) 515 
locks 83 
message prefix 146 
PIU discard reason codes 1141 
printer commands for VSCS_ 185 
recovery machine, activating 144 
service aids 213, 347, 411 
shared segment (DCSS), map of 50 
SIMLOGON fails 185 
trace fields 
MVS-only fields 367 
VM-only fields 367 
traces 
activating 349 
buffer contents 369 
buffer use (SMS) 377 
VO 373 
internal 397 
printing with ACF/TAP 361 
printing with CPTRAP 359 


LY43-0065-01 © Copyright IBM Corp. 1984, 1995 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


VTAM (continued) 
traces (continued) 
printing with IPCS 362 
printing with TPRINT 363 
SMS (buffer use) 377 
TGET/TPUT, for TSO/VTAM 380 
wait state indications 6, 39 
VTAM dump analysis 
diagnosing problems in 46 
VTAM exit trace (VSCS) 131, 458 
VTAM internal trace (VIT) 
activating 398 
analysis 
See VIT analysis tool 
deactivating 410 
extracting information 434 
address 436 
boolean expression freeform 437 
offset, address 436 
offset, string, character 436 
offset, string, hex 436 
operands, boolean freeform 437 
options, entries 435 
restriction 437 
sample output 439 
string, character 436 
string, hex 436 
syntax 439 
template 434 
missing trace records 19 
module names in trace records 405 
options (OPTION operand) 398 
record descriptions 
A2 593 
ABND 569 
ACA1 570 
ACA2 572 
ACA3 573 
ACI1 570 
ACI2 572 
ACI3 573 
ACP1 574 
ACP2 576 
ACR1 574 
ACR2 576 
ACRC 578 
ACSN 579 
ACU1 580 
ACU2 580 
ADP2 583 
ADPA 582 
ADPI| 582 
ADPO 582 
ADSP 584 
All 585 
Al2 587 
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record descriptions (continued) 

Al3 588 

ALS 589 

AP 591 

AREL 594 

ATSK 595 

ATT 596 

AXIT 597 
-BSPx 598 

BSS 599 

BSX 600 

BTSK 601 

CC2 for NCSPL 605 
CC2 for RUPE 603 
CCl for NCSPL 604 
CCI for neither RUPE nor NCSPL 606 
CCl for RUPE 602 
CCO for NCSPL 604 
CCO for neither RUPE nor NCSPL_ 606 
CCO for RUPE 602 
CFC2 609 

CFCE 607 

CFCN 608 

CFD2 611 

CFDS 610 

CFEE 612 

CFER 615 

CFFC 616 

CFL2 619 

CFLS 617 

CFNF 620 

CFRB 621 

CFUS 623 

Cli 625 

Ci2 628 

Ci3 631 

Cl4 632 

CNA 633 

CNP1 636 

CNP2 638 

CNP3S 639 

CNR1 636 

CNR2 638 

CNR3 639 

CO1 625 

CO2 628 

CO3 631 

CO4 632 

CONN 640 

CPP2 643 

CPP3 644 

CPP4 645 

CPPG 641 

CPPT 641 

CPR2 647 
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record descriptions (continued) 


VTAM internal trace (VIT) (continued) 
record descriptions (continued) 


IRBD 711 
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CPR3 648 IRBX 712 
CPRC 646 LCS2 717 
CPTO 649 LCSL 713 
CPW2 651 LCSM 718 
CPW3 652 LCSP 713 
CPW4 653 LCSS 713 
-~CPWT 650 LCSX 713 
CRA add 654 LIC] 720 
CRD delete 654 LICO 720 
CRF find 654 LICS 720 
DBD delete 656 LKEX 723 
DBQ query 656 LKSH 724 
DBU update 656 LNKA 725 
DISC 657 LNKI 725 
DLT 658 LNKL 725 
DLT2 661 LNKx 725 
DSC2 663 LOST 727 
DSCD 662 LSN2 730 
DSP 664 LSNA 728 
DTSK 666 MIC 731 
ERP for VM _ 667 MIE 732 
ERP for VSE 667 Mil 733 
ERP2 for VM_ 670 MPT 734 
ERP2 for VSE 670 MPT2 735 
ERPI or ERPL 671 MSG 736 
ERPx for VM 668 MSG2 739 
ERPx for VSE 668 MSGS 738 
ESC 672 MU1 740 
ETSK 673 MU2 743 
EXIT 674 MU3 744 
EXPN 676 MU4 746 
FBL2 568, 681 NMP2 748 
FBLK 678 NMPT 747 
FFST (****) 568 NRS2 750 
GBL2 685 NRSP 749 
GBLK 682 NSD 751 
GNA2 687 OPE2 753 
GNAM_ 686 OPER 752 
HiIO 688 PIC 754 
HIOP 690 © PIU 755 
INT for MVS 693 PIU2 756 
INT for VM_ 692, 695, 701 PKT| 757 
INT for VSE 698 PKTO 757 
INT2 694 PKTX 758 
lO1 703 POST 759 
lO2 for MVS 705 PROA 760 
lO2 for VM 706 PROD 760 
102 for VSE 705 QREQ 761 
lO3 for MVS 707 QRYL 762 
lO3 for VM 708 QUE 763 
103 for VSE 707 QUEN 765 
IPC 709 RACR 766 
IP! 710 RCE 767 
RDS2 769 
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VTAM internal trace (VIT) (continued) 
record descriptions (continued) 


VTAM internal trace (VIT) (continued) 
record descriptions (continued) 


RDSC 768 XID2 833 

RE 770 XPST 834 

RELS 772 RU counting 426 

REQ2 776 network address 426 
REQS 774 output, sample 430 

RESM 777 parameters, RU 427 
SCHD 779 request/response units 426 
SIO for MVS 782 RU 426 

SIO for VM 781, 782, 784 syntax 427 


SIO for VSE 781, 782 
SlO2 for MVS 784 
SlO2 for VSE 784 


selecting internal or external recording 
MODE=EXT 403 
MODE=INT 401 


SIOP 786 SNAP trace record 408 

SOCA 788 storage, analyzing 417 

SOCD 788 ASID 418 

SOCF 788 buffer pools 418 

SOCR 788 matching 417 

SOCx 788 sample output 419 

SPT 789 storage lengths 417 

SPT2 791 syntax 418 

SRBD 792 | unmatched allocate 417 
SRBX 793 trace table header record 402 
SRT2 795 using 397 

SRTA 794 VTAM locks, description of 80 
SRTC 794 VTAM Services 

SRTD 794 messages issued by 176 
SRTF 794 VTAMMAP control card 232 
SRTx 794 VTAMMAP, IPCS 240 

TGM 796 See also VERBEXIT VTAMMAP, IPCS subcommand 
TGM2 798 VTFNDMOD VTAMMAP_ 332 
TREB 799 VTFR trace record 828 

TRED 799 VTMODS VTAMMAP_ 334 

TREI 799 VTVIT VTAMMAP 340 

TREM 799 | VTVRBLK VTAMMAP 342 

TRN2 803 VTWRE VTAMMAP) 344 

TRNM_ 801 VWAI trace record 829 

UE 804 

UE1 805 

UE2 807 W 

ULKA 808 wait 

UNLK 809 application program 70 

UP 810 conditions 

VCC1 812 process waits for a buffer 79 
VCC2 814 process waits for a resource 79 
VCDQ 815 during VSCS termination 151 
VCP1 819 option 129 

VCP2 823 session 70 

VPST 824 wait problem (VSCS), diagnostic procedure for 159 
VRSM_ 825 WAIT trace record 830 

VTAL 826 waiting 

VTFR 828 request element (WRE) 75, 77 
VWAI 829 RPH 79 

WAIT 830 

XID 832 
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ways to recover a hung LU (VSCS)_ 163 

WEB function codes (VSCS) 535 

work areas (to trace execution sequences) 552 

wrapping of data on screen 124 

WRE (waiting request element) 75, 77 

write control character in buffer contents trace 
output. 120 


X 


X.21 switched lines 
dial and answer 1011 
dial channel program 918 
establishing 1011 
XID trace record 832 
X|ID2 trace record 833 
XPST trace record 834 
XREF (link-edit) map 50 
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